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INTRODUCTION 



Until now, 4051 Graphic System users have relied on magnetic tape for data and program 
storage. Now, however, the 4907 File Manager (incorporating the 4051, the 4907 ROM 
pack and the 4907 disc drives) changes that. The changes include much more versatile 
file management, faster file access, and increased storage capacity. Much of the 
improvement is due to the 4907's flexible magnetic discs, but there is more to it than that. 

Improved file management is due also to the many new "ROM pack" commands added to 
the 4051 's BASIC vocabulary. These commands, when used with regular 4051 
commands, allow: 

• File naming 

• File security with passwords 

• Automatic increases in file space when necessary 

• File copying 

• Multiple file access 

• Recording time and date of all file activities 

• File renaming 

• Five file storage levels 

• Fast access within files with 'random' access 

The 4907 File Manager definitely increases the potential and versatility built into your 
4051 . We believe you'll find this addition to the 4051 product line a valuable and efficient 
tool in all your information storage activities. 



ABOUT THIS MANUAL 

This manual explains how to operate the 4907 File Manager after the procedures outlined 
in the 4907 Installation Guide have been carried out. 

In order to use this manual and the 4907 File Manager effectively, you must have a 
working knowledge of the 4051 Graphic System. Most of the descriptions, procedures 
and terms in this manual have been written on that basis. 

Those aspects of data transfer (I/O) and related subjects not covered in this manual are 
fully described in the 4051 Graphic System Reference Manual. 
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Your 4051 Graphic System and 4907 disc drives, together, are referred to as "the 
system" throughout this manual. Your 4051 is often called a "host." Although the 4051 is 
generally purchased separately, it is considered part of "the system" for purposes of 
discussion. 



HOW TO USE THE MANUAL 

This manual is written to help you create and use disc files effectively and efficiently. 

We suggest that you take time to familiarize yourself with the following sections of the 
manual before attempting to operate the system. 

1 . FRONT PANEL CONTROLS AND INDICATORS 

This portion of the GENERAL DESCRIPTION section describes the switches and 
indicators on the front of your system controller and disc drives. 

2. GENERAL OPERATION 

Ttiis section outlines the steps required before the system can be used, 
including GPIB cable & ROM pack installation, power up, and disc loading. It also 
shows you the steps that are necessary to create and use your first files. This 
section contains command summaries that show the general construction and 
provide a brief description of each command. Review the GLOSSARY (Appendix 
D) to understand the terms used. 

3. STORAGE STRUCTURE 

This section describes the concepts of file storage. It is necessary to understand 
these concepts to write file identifiers (F.l.s), which are necessary parts of many 
commands. 

4. HOW TO WRITE A COMMAND 

This section describes the basic rules for writing commands. It shows the 
general order of the fields and what they do. It also describes the terms used 
in individual command descriptions. 
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HOW TO WRITE A FILE IDENTIFIER 

This part of Section 4 describes the rules for writing fi le identifiers. A file 
identifier, or F.I., is required in many commands. It helps to deliver information 
like an address on an envelope but it can also create the destination (file). In 
short, the F.I. tells the 4051 which file is Involved in the operation and where it 
is to be created or where it can be found. 



5. COMMAND DESCRIPTIONS 

4907 File Manager commands are categorized and described in COMMAND 
DESCRIPTIONS. 



QUESTIONS AND ANSWERS 

The following questions and answers may help you in using the manual. 

Q. HOW DO I CREATE A FILE? 

A. Look in GENERAL OPERATION (Section 2) for the required steps. 

Q. WHAT KIND OF FILE SHOULD I USE? 

A. 4907 File Manager files are random or sequential and can contain either ASCII or 
binary data or programs. See WHAT ARE RANDOM AND SEQUENTIAL FILES in 
GENERAL OPERATION (Section 2). Also see the descriptions of WRITE and PRINT in the 
4051 Graphic System Reference Manual. 

Q. HOW CAN I BE SURE I'M ENTERING COMMANDS IN CORRECT ORDER? 

A. Study the GENERAL SEQUENCE FLOW CHART in Section 2. You can see what the 
command prerequisites are, if any, by reading the command description. 

Q. WHAT IS AN F.I. AND WHAT DOES IT DO? 

A. The F.I., or file identifier, is used in many commands to tell the system what the name 
of the file is and where it is to be placed or where it may be found if it already exists. 
See STORAGE STRUCTURE (Section 3) and HOW TO WRITE A FILE IDENTIFIER in 
Section 4. 
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Q. WHAT IS A CURRENT DEVICE? 

A. Commands containing logical file numbers or F.l.'s, but no device addresses, will be 
directed to the "current device." This device must be specified earlier in a UNIT or 
CALL "UNIT" command. 



Q. WHAT IS THE CURRENT LIBRARY? 

A. See CALL "USERLIB" command description in Section 5. 

Q. WHAT HAPPENS IF INCORRECT COMMANDS ARE ATTEMPTED? 

A. You will generally get an error message if illegal or syntactically incorrect commands 
are attempted. If strange results occur even though correct commands have been 
executed, the cause could include: 

• accessing the wrong device 

• not executing a UNIT command 

• opening a file incorrectly 

• using incorrect variables or variables already active in the 4051 

• not executing an INIT when necessary 



In case of problems, check the sequences required as well as the individual operations. 
Be sure the problem is not caused by incorrect use of the 4051 or faulty programming. 



NOTE 

If an undefined variable is entered in any CALL command, an error 
message appears that advises you of an illegal command (instead of an 
undefined variable message). No error message occurs if the field is 
defined as a target string variable in the command description. 

Q. HOW DO I GET DATA IN AND OUT OF MY FILES? 

A. See FILE I/O COMMANDS in Section 5. Also see SAMPLE I/O PROGRAM in Section 2. 
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Q. WHAT ABOUT PROGRAMMING? 

A. All normal 4051 programming rules apply. No regular 4051 BASIC commands are 
disabled. See the program examples in INPUT and READ command descriptions in 
Section 5. Also see SAMPLE PROGRAMS, USING PRINT AND INPUT IN A 
PROGRAM, USING WRITE AND READ IN A PROGRAM, and SAMPLE I/O PROGRAM 
in the appendices. 



Q. WHAT ABOUT EXTERNAL DEVICES SUCH AS INSTRUMENTATION AND PRIN- 
TERS? 

A. The system does not provide for "spooling"; that is, the devices or disc controller 
cannot listen or talk directly to other external devices. All interaction between the 
system and peripheral devices must go through the host (4051). 



Q. HOW LARGE SHOULD I MAKE MY FILES OR FILE RECORDS? 
A. See the CREATE command description in Section 5. 

Q. HOW CAN I CHECK TO SEE HOW MUCH SPACE IS AVAILABLE ON A DISC? 
A. See CALL "DSTAT" command description. 

Q. HOW DO I RECOVER OPERATION IF EXECUTION IS HALTED AND AN ERROR 
MESSAGE APPEARS? 

A. Most error messages describe the error involved. For more details, see ERROR 
MESSAGES AND RECOVERY PROCEDURES (Appendix B). 

Q. CAN I USE THE 4907 WITH ANY GPIB TALKER? 

A. No. The GPIB device must be a controller; that is, talker and listener. 
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Rgure 1-1. 4907 (Single Drive). 
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Figure 1-2. 4907 Option 30 (Two Drives). 
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Rsure 1-3. 4907 Option 31(Th,ee Drr.es). 
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GENERAL DESCRIPTION 



INTRODUCTION 

All 4907 File Managers are designed for use with a 4051 Graphic System, which controls 
all storage activity.'' 

The 4907 File Manager includes a 4907 ROM (Read-Only Memory) pack and a 4907. The 
4907 contains a disc controller and from one to three flexible disc drives. 

The ROM pack, which plugs into the 4051 , provides extra BASIC commands for use by 
the 4051. These commands are transmitted from the 4051 keyboard or program through a 
GPIB cable to the 4907 disc controller in an adjacent cabinet. The controller activates the 
single flexible disc drive in that cabinet and, if part of the system, one or two more disc 
drives in a second cabinet. These drives contain the flexible magnetic discs used for data 
storage. 

The 4907 is shipped in one of three configurations: 

1 . 4907 (single disc drive). 

2. 4907 Option 30 (two disc drives). 

3. 4907 Option 31 (three disc drives). 

4907 CONFIGURATION 
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Figure 1 -4. Diagram of 4907 Configuration. 



^ Except for front panel switches on disc drives and disc controller. 
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4907 OPTION 30 CONFIGURATION 
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Figure 1 -5. Diagram of 4907 Option 30 Configuration. 
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Figure 1-6. Diagram of 4907 Option 31 Configuration. 
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FRONT PANEL CONTROLS AND INDICATORS 

4907 Controller and Single Flexible Disc Drive Cabinet 




©0® ® ® 
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Figure 1 -7. Front Panel Controls and Indicators for 4907 Main Cabinet. 

1. Power indicator. 

2. Power switch. 

3. Busy indicator. If lit, disc operation is being carried out. 

4. Fault indicator. If lit, system is inoperative. If restart efforts fail, see 4907 Service 
Manual or contact a Tektronix technician. 

5. File open indicator. If lit, one or more files on a disc are open. Some commands 
cannot be executed if files are open. See Prerequisites in COMMAND 
DESCRIPTIONS (Section 5). 

6. Clock indicator. If lit, system clock must be set. 

7. Busy indicator. If lit, disc operation is being carried out. 

8. Write protect switch. 2 

9. Write protect indicator. If lit, device or flexible disc is in the write-protect state. 

1 0. Drive door release. 



^Disc may be write-protected independent of switch setting. 
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4907 Option 30 Single Flexible Disc Drive Cabinet 
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Figure 1 -8. Front Panel Controls and Indicators for 4907 Option 30 Single Drive Cabinet. 

1 . Power indicator.3 

2. Power switch. 

3. Busy indicator. If lit, disc drive operation is being carried out. 

4. Write-protect switch. * 

5. Write-protect indicator. If lit, device or flexible disc is in the write-protect state. 

6. Drive door release. 



^Even though indicator may be lit, the unit becomes inoperative if power switch on the main cabinet is 

turned off. 
^Disc may be write-protected independently of switch setting. 
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4907 Option 31 Dual Flexible Disc Drive Cabinet 
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Figure 1 -9. Front Panel Controls and Indicators for 4907 Option 31 Dual Drive Cabinet. 

1. Power indicator. 3 

2. Power switch for both drives. 

3. Left drive door release. 

4. Write-protect indicator for left drive.^ 

5. Write-protect switch for left drive.^ 

6. Busy indicator. If lit, left drive operation is being carried out. 

7. Busy indicator. If lit, right drive operation is being carried out. 

8. Write-protect switch for right drive.^ 
9. Write-protect indicator for right drive.^ 

1 0. Right drive door release. 



^If lit, device or flexible disc is in the write-protect state. 
^Disc may be write -protected independent of switch setting. 
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STANDARD/OPTIONAL ACCESSORIES 

All 4907 File Manager systems come with the standard accessories listed directly below. 
The systems with Option 30 or Option 31 contain additional standard accessories which 
are listed under those headings. 



4907 Standard Accessories 

4907 File Manager Operator's Manual 

Power Cord 

1 Flexible Disc Media 

Box of Cleaning Pads (10) 

GPIB Cable 2M 

4907 Installation Guide 

4907 File Manager Pocket Reference Card 

4907 File Manager ROM Pack 

4907 File Manager Label Set 



4907 Optional Accessories (All Options) 

Box of Flexible Disc Media (1 0) 

4907 Service Manual 

GPIB Cable 4M 

Flexible Disc Drive Service Manual 

Alignment Disc 



4907 Option 30 Standard Accessories 

Power Cord 
Interconnect Cable 
Strain Relief Bracket 
Clamp 

1 Flexible Disc Media 
Box of Cleaning Pads (1 0) 
4907 Installation Guide 
4907 File Manager Label Set 
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4907 Option 31 Standard Accessories 

Power Cord 

Interconnect Cable 

Strain Relief Bracket 

Clamp 

2 Flexible Disc Media 

Box of Cleaning Pads (1 0) 

4907 Installation Guide 

2 4907 File Manager Label Sets 



4907F32 Field Update Kit Standard Accessories 

This kit Is used to add a drive to a two-drive system; this creates a system Identical to the 
4907 Option 31. 

1 Flexible Disc 
Box of Cleaning Pads (1 0) 
4907 Installation Guide 
4907 File Manager Label Set 

4907F32 Kit Includes these components: 

Drive Kit 
Front Panel 
Wire Kit 

Ribbon Cable, 50 Conductor 
Ribbon Cable, 40 Conductor 
Write-Protect Switch with Bezel 
LED for Write-Protect Switch 
LED (Busy) with Recessed Washer 
Cable Ties (2) 
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INTRODUCTION 



This section outlines the steps required before the system can be used, including GPIB 
cable and ROM pack installation, power up, and disc loading. It also shows the steps that 
are necessary to create and use your first files. This section contains command 
summaries that illustrate the general construction and provide a brief description of each 
command. Review the GLOSSARY (Appendix D) to understand the terms used. 



PREPARATION 

Certain preparatory steps must be performed before the 4907 File Manager can be used. 
First, any necessary address strap and line voltage changes must be made. The line cord 
or cords, ribbon cable, ■• ROM pack, and GPIB cable must then be installed. The system is 
then powered up, the discs loaded, and performance checks carried out. All these 
procedures are described in the 4907 Installation Guide. 

When the procedures described in the 4907 Installation Guide have been performed, the 
File Manager is ready for use. 



NOTE 

Because GPIB cabling, ROM pack installation, power up, and disc loading 
are regularly repeated operations, they are included in this manual as well 
as in the 4907 Installation Guide. 



^ Not applicable to the single disc drive 4907. 
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GPIB Cable and ROM Pack Installation 

1. Turn off 4051. 

2. Connect the GPIB cable from the rear of the 4051 to the rear of the main 4907 cabinet 
(Figure 2-1). 




Figure 2-1. Connecting GPIB Cable to Rear of Main 4907 Cabinet. 



3. Plug the 4907 File Manager ROM pack into any available slot in the 4051 back pack 
(Figure 2-2) or into a ROM Expander. BE SURE THE 4051 HAS BEEN TURNED OFF. 




Inserting any device into or removing any device from a 4051 backpack 
slot or a ROM Expander slot when power is on may cause memory to be 
erased. 
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Figure 2-2. Plugging in ROM Pacl(. 




The ROM pack may also be plugged into any available slot in any 405IEO1 
ROM Expander. Only one 4907 File Manager ROM pack may be plugged 
into either the ROM expander or the backpack on the same 4051. 
Installing more than one of these ROM packs sets up a conflict since each 
4907 would be considered GPIB device No. 0. 

4. The 4907 can now be powered up. See POWER UP. 
Power Up 




// multiple GPIB devices are interfaced to the 4051 at least half of them 
plus one must be turned on before turning on the 4051. If this is not done 
the I/O indicator may light continuously, indicating a system hang-up. The 
devices must be turned on even if they are not going to be used. The 
alternative is to disconnect them entirely. 
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4907 (Single Drive) 

1 . Turn on front panel power switch on main 4907 cabinet. 

2. Turn on 4051. 

4907 Option 30 and 4907 Option 31 

1 . Turn on front panel power switch on main 4907 cabinet. 

2. Turn on front panel power switch on auxiliary cabinet. 

3. Turn on 4051. 

Loading the Flexible Disc Drive 

1 . Press drive door release on front of drive and place flexible disc in cavity as shown 
(Figure 2-3). Slide disc, with label up, as far in as it will go. Be sure the tape supplied 
with the disc is covering the write-protect hole whenever formatting or writing to a 
disc. To write-protect a disc, remove the tape covering the write-protect hole. 




Figure 2-3. Placing Flexible Disc in Drive. 
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2. Close door (Figure 2-4). 




Figure 2-4. Closing Drive Door. 

3. Repeat sequence with additional drives, if necessary. 

4. Start operation. 
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Flexible Disc Storage and Handling 

• Do not place heavy objects on disc cartridge. 

• Keep fingers off disc surface. 

• Do not write directly on cartridge but use labels instead. 

• Attempts to clean the disc may damage the surface. 

• Keep disc away from heat and sunlight. 

• Allow a disc at least five minutes to adjust to existing temperature and humidity 
before using. 

• Store discs vertically to prevent dust from settling on disc surfaces. 

• Keep cartridges away from magnetic fields and magnetic material. Magnetism can 
destory stored data. 
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READY TO START? 

At this point you probably know what kind of information you want to store but not the 
procedures necessary to store it. 

The GENERAL SEQUENCE FLOW CHART shows the steps necessary in creating and 
using files. By reading the accompanying text you'll get a good idea of the general 
requirements. 

Occasionally, commands not shown in the flow chart will be necessary; for example, you 
may wish to change the name or attributes of a file or reduce allocated file space. For a 
quick look at all system commands, what they will do and their general construction, see 
COMMAND SUMMARIES in this section. For more detailed information see COMMAND 
DESCRIPTIONS (Section 5). 

A small program demonstrating how to create a random and sequential file is included in 
this section (SAMPLE I/O PROGRAM). This program also shows how to write binary 
information and print ASCII information to these files as well as how to recover it. The 
differences between random and sequential files are described in WHAT ARE RANDOM 
AND SEQUENTIAL FILES? 

The 4907 File Manager offers features normally not found in other storage systems. 
These features and the associated commands are discussed in SPECIAL SYSTEM 
FEATURES in this section. 

Naturally there is more to operating the 4907 File Manager than jockeying commands 
around. How you write those commands will make the difference in your use of system 
capabilities. To write effective commands you should become familiar with storage 
concepts and "file identifiers." See STORAGE STRUCTURE (Section 3) and HOW TO 
WRITE A FILE IDENTIFIER in Section 4. 
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Set System Clock 



CALL "SETTIM" 



I 



Choose Device 



UNIT 



Yes 




Reserve Device 



CALL "DRES" 



I 



Format Disc 



CALL "FORMAT" 



I 



Release Device 




Yes 



Activate Device 



CALL "MOUNT" 



~[ 



CALL "DSTAT 



1 . Set System Clock 

The CALL "SETTIM" command starts the system clock so 
the time and date of various system activities are recorded. 
This command is required each time the system is turned 
off and restarted. There is no "default" time provided. This 
command is mandatory. 

2. Choose Device 

The UNIT command identifies which device is to be the 
"current" device, the one the system accesses whenever it 
receives a command that does not specifically name some 
other device. The address to be used in this command can 
be seen on or around the face of the device. Device will 
always be accessed if no UNIT command is executed. 

3. Has Disc Ever Been Formatted? 

All discs must be formatted before they are used for the 
first time or when all existing information is to be replaced. 
If the disc already has been formatted and has valid 
volume label information, no formatting is necessary. CALL 
"MOUNT" notifies the system that there is a formatted disc 
ready for use. 

4. Reserve Device 

The device must be reserved with CALL "DRES" before 
any preparatory disc operation, such as formatting, can 
take place. 

5. Format Disc 

The disc may now be formatted with the CALL "FORMAT" 
command. This command also executes an automatic 
CALL "MOUNT" to notify the system that there is a 
formatted disc ready for use. 

6. Release Device 

The reserved device must now be released with a CALL 
"OREL" command. If the device is not released, no files can 
be opened. 

7. Is Device Status Message Necessary? 

If you wish to confirm that the correct disc is in the drive, or 
what the specifications of that disc are, you may execute a 
CALL "DSTAT" command. This also allows you to see if the 
disc has been formatted. 

At this point, preparatory work involving the disc is 
complete. Steps 8 through 1 6 show commonly used file 
operations on a disc prepared as shown in Steps 1 through 7. 



A 
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Figure 2-5. General Sequence Flow Chart 
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GENERAL SEQUENCE FLOW CHART (cent) 



At this point, preparatory work involving the disc is 
complete. Sequences 8 through 1 6 show? commonly 
used file operations on a disc prepared as show^n in 
steps 1 through 7. 

8. Has File Already Been Created? 

if you wish to store information and no file has yet been 
created to receive it, the CREATE command must be 
executed.'' This command allows you to specify: the name 
of the file and its attributes, the length of the file, the 
number of logical records the file will contain, and whether 
the file is random or sequential. 

9. Has File Been Initialized? 

Although information may be "randomly" read from a 
random file, it must be entered sequentially unless the 
records are first filled with "blank strings." See file initializ- 
ing program in the section SAMPLE I/O PROGRAM. This 
program enters blank strings into a file, allowing random 
data entry. 



1 0. Is File Operation to be SAVE, OLD, APPEND 
or COPY . . . TO? 

These operations may be carried out without the OPEN and 
CLOSE commands. 

11. Open File or Files 

An OPEN command must be executed for those file 
operations listed in Step 1 3. This command also generates 
and stores a file status message for each file opened. 
Another UNIT command, as in Step 2, is necessary to 
access a file on a different device. 

12. Is a File Status Review Necessary? 

It may be necessary to review the status of the file or files 
just opened. The parameters include the time and date the 
file was created, altered, and last used, as well as its name, 
attributes, and space specifications. To see what details 
are included and how they are displayed, turn to SAMPLE 
DEVICE AND FILE STATUS MESSAGES. If you do wish to 
review the file status, enter the string variable that was 
specified in the last field of the OPEN command. 



Except for a SAVE which can create its own file. 




Execute File 

Initialization 

Program 



Yes 



10 /isFile^ 
Operation to^ 
be: SAVE, OLD, 
APPEND or 
JOPY.TO?. 



11 



Yes 



Open File or Files 



OPEN 



Yes 



1 



Enter the 
String 

Variable 
Containing 
the Status 

Message 




SAVE, OLD 
APPEND or 
COPY . . .TO 



(h 



Figure 2-6. General Sequence Flow Chart. 
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GENERAL SEQUENCE FLOW CHART (cont) 



13 



/ 


Is File 
Empty? 


\ No 






X 


? 






[Yes 






\ 


\ 


1 




WRITE 




\ 










13a 


or 
PRINT 




A Variety of 

File Management 

and File I/O 
















Commands Possible: 






13b 


READ 
WRITE 
PRINT 
INPUT 
REWIND 










1 


\ 




14 


y 


\ 







1 3. Is File Empty? 

If the file has just been created, it contains no Information. 
Information now may be entered into the file using a WRITE 
or PRINT command. 

If the file is full or partially full, as indicated in a file status 
message, a variety of file management and file I/O 
operations may be executed. For example, the following 
commands are now possible: 

WRITE ... for entering binary information 
PRINT ... for entering ASCII information 

READ ... for retrieving binary information 
INPUT ... for retrieving ASCII information 




Go Back To 
Steps 



Deactivate the Disc 



CALL "DISMOUNT' 



CALL "REWIND' 
the file. 



resets the file pointer to the beginning of 



These commands are used to carry out some of the more 
common file management operations. The command exam- 
ples in How to Write a Command, in the 4907 File Manager 
Operator's Manual, outline other operations that are less 
common. 

1 4. Is It Necessary to Close the File? 

If no further file access is necessary, the file may be closed 
by executing a CLOSE command. This automatically 
releases the file. It is not necessary to close the file in 
order to open another, because up to nine files may be 
opened and used simultaneously. 

1 5. Is It Necessary to CREATE or Access An- 
other File on the Same Device? 

Your operation may require placing data into or retrieving 
data from more than one file at a time. If you wish to access 
or create another file on the same device, go back to Step 
8. If no further access to this device is necessary, it may be 
dismounted by executing CALL "DISMOUNT". All files 
must be closed before executing this command. If you wish 
to access a file on a different device, go back to Step 2. 
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Figure 2-7. General Sequence Flow Chart. 
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Command Summaries 

Information in parentheses helps describe the preceding field (except in TYPE and ON 
EOF summaries where the parentheses are actually part of the syntax). Ifn means "logical 
file number." Remember that all F.l.s (File Identifiers) must be within quotation marks. 



NAME (KEYWORD) AND 
GENERAL FORMAT 


FUNCTION 


APPEND F.I.[,"ASCII"]; target line num- 
berUncrement between line numbers] 


Adds the program in specified file to memory 
at the stated line number. 


ASSIGN F.l.;attributes (R,U,S,C,N,M) 


Changes file attributes such as: 

R Private 

U Public 

S Scattered 

C Contiguous 

N Not Compressible 

M Compressible 


CLOSE [Ifn] 


Closes one or all files. 


CALL "COMPRS", device address, 
compress control (1 or 0) 


Collects all scattered free space on the disc 
into one contiguous space. 


COPY . . . F.I. #1 .source device ad- 
dress TO F.I. #2 .target device ad- 
dress 


Copies files to the same or another disc. 


CREATE F.I. [.attributes]; number of 
logical records, record length 


Defines a new empty file. 


CALL "OUST AT", target string variable 


Generates a device status message for each 
device interfaced to the 4907 File Manager 
controller and stores them in the specified 
string variable. 


DELALL 


Erases everything currently in 4051 memory 
and closes all files. 
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DIRECTORY [I/O address:] [format 
code (0, 1, or 2) [,F.I.]] 


Lists (to 4051 screen or mag tape) facts 
about specified files in storage. 

Depending on the format code entry, listings 
can include: 

File names only. 

1 File names and dates. 

2 Full file status. 


CALL "DISMOUNT", device address 


Deactivates specified device when all open 
files are closed. Device remains active until 
all files are closed. Until files are closed, I/O 
may continue but no new file can be opened. 


CALL "DREL", device address 


Releases a reserved disc drive. 


CALL "DRES", device address 


Reserves a disc drive. 


CALL "DSTAT", device address, tar- 
get string variable 


Generates a status message about the disc 
in the drive or the device specified. 


CALL "DUP", source device address, 
target device address, compress con- 
trol (0 or 1 ) 


Duplicates contents from one disc to an- 
other. 


END 


Stops program execution and closes files. 


CALL "FFRMT", 


Initializes a disc without searching first for 
defective sectors. See CALL "FORMAT". 


CALL "FILE", device address, F.I., tar- 
get string variable 


Stores status message of named file in 
specified string variable. 


CALL "FMVALS", target numeric vari- 
able, target string variable 


Sends the number of the current device to 
the numeric variable specified and the name 
of the current library to the string variable 
specified. 


CALL "FORMAT", device address, vol- 
ume I.D., 1,1, owner I.D., master pass- 
word, 1st, 2nd, 3rd, 4th, and 5th 
level chains 


Records an information label on a new disc 
after searching for bad sectors. The disc is 
then automatically mounted. Any previous 
data is now inaccessible. 
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CALL "HERRS", device address, num- 
ber of retries in last I/O, number of 
accumulated retries, number of suc- 
cessful I/O recoveries, number of un- 
successful I/O operations 


Generates a count of I/O errors. 


INIT 


Resets all 4051 string, numeric, and array 
variables to an undefined state and closes 
all files. 


INPUT #lfn [,record number]: target 
variables [.target variables] . . . 


Inputs ASCII file data from the disc to the 
4051 ; sequential or random access is per- 
mitted. 


KILL F.I. [.master password] 


Deletes existing files. 


CALL "MOUNT", device address, tar- 
get string variable 


Activates disc and returns disc status mes- 
sage. 


CALL "MRKBBG", device address, 
volume I.D., master password, ad- 
dress of defective space 


Marks defective blocks on the disc so they 
aren't used again. 


CALL "NEXT", Ifn, target string 
variable 


Closes current file and opens the next one. 


OLD F.I. [,"ASCII"] 


Works like 4051 keywords "OLD" and 
"BOLD" (see the 4051 Graphic System 
Reference Manual). 


ON EOF (Ifn) 


See 4051 Graphic System Reference 
Manual. 


Open F.I.[,"G"]; Ifn, type of access 
(R,F,U), target string variable 


Opens a file for I/O operation. 


PRINT #lfn [,record number]: data 
item, data item . . . 


Transfers ASCII data from the 4051 to the 
disc or tape. 
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READ #lfn [.record number]: target 
variables [.target variables] . . . 


Transfers binary data from the open file to 
the 4051. 


CALL "RENAME", device address, 
old F.I., new F.I. 


Renames files and changes passwords. 


CALL "REWIND", Ifn 


Sets logical file pointer back to beginning of 
file. 


SAVE F.I.[,"ASCII"]; line number 
[beginning, ending line number] 


Stores program into disc file. A file will be 
created if none exists. 


SECRET 


Prevents future program listing. 


CALL "SETTIM", date and time 


Sets and starts the system clock. 


CALL "SPACE", Ifn, requested file size, 
target numeric variable, target numeric 
variable 


Decreases the size of a file to the minimum 
size required for its contents. 


CALL "TIME", target string variable 


Stores the current time from the system 
clock in a specified string variable. 


TYPE (Ifn) 


Works the same as TYP{0) does for internal 
magnetic tape. 


UNIT device address 


Selects current device address for all com- 
mands that do not contain a field for a 
device address. 


CALL "UNIT", device address 


Same as UNIT but allows a variable in the 
device address field. 


CALL "USERLIB", partial F.I. 


Specifies current library. The default current 
library is "SCRATCHLIB". 


WRITE #lfn [,record number]: data 
item[,data item] 


Transfers binary data from the 4051 to an 
open file. 
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Sample I/O Program 

The program listed below shows the basic steps necessary to create files and write and 
print to those files. It also shows how to retrieve and print the information stored in those 
files. 

If error messages occur, check ERROR MESSAGES AND RECOVERY PROCEDURES 
(Appendix B). Be sure that all entries are correct and that all preparatory steps described 
earlier in this section have been performed. 

A description of the program operations and a sample of the program output follow the 
program listing below. 



160 INIT 

lie DIM RfC20ee>,F$(2ee> 

120 CALL "TIME%R$ 

130 IF LEN(Rf>>0 THEN 170 

140 PRINT -ENTER DATE AND TIME <DD-MOM-YY HH:MM:SS):"; 

150 INPUT A$ 

160 CALL '•SETTIM%At 

170 PRINT -HOW MANY DEVICES ON YOUR SYSTEM?: "J 

180 INPUT N 

190 DIM D<N) 

200 PRINT "ENTER DEUICE ADDRESSES: "J 

210 INPUT D 

220 FOR I«l TO N 

230 PRINT "JJTHIS IS A SAMPLE PROGRAM FOR DEUICE •*;D<I)rj" 

240 CALL "UNIT%D<I> 

250 CALL ••DRES",D<I> 

260 CALL -F0RMAT*fD(I),"SAMPLEM,l,«0WHER%"PASS%3,3,3,3,3 

270 CALL "DREL%D<I> 

280 CREATE "ASCFILE", "A"? I ,0 

290 CREATE "BINFILE" J 1, 128 

300 OPEN "ASCFILE-Uf-F'SF* 

310 PRINT «i:-THIS IS AN ASCII SAMPLE (SEQUENTIAL FILE)" 

320 OPEN "BINFILE";2,"F%F$ 

330 WRITE #2,1: "THIS IS A BINARY SAMPLE (RANDOM FILE)" 

340 CALL "REWINDM 

350 INPUT «l:S$ 

360 PRINT St 

370 READ i2,l:S$ 

380 PRINT S* 

390 CLOSE 

400 NEXT I 

410 END 
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Program Description 



100 
110 
120 
130 
140 
150 
160 
170 
180 
190 
200 
210 
220 
230 
240 



Initialize 



Set system clock, if necessary 



Enter the total devices on your system (1 , 2, or 3) 



Enter the device addresses (0 or 0, 1 , etc.) 

Print heading 
Set unit number 



250 \ 

260 [ Format disc 

270 ) 

280 Create an ASCII, sequential file 
290 Create a binary, random file 



300 
310 
320 
330 



Open each file and store message 



340 Rewind sequential file 



350 1 
360 
370 
380 



Access files and display messages 



390 Close both files 

400 

410 End program 
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Sample Program Output 



RUN 

ENTER DATE AND TIME <DD-M0I1-YY HH:I1M:SS>: 12-DEC-77 08:30:30 

HOW MANY DEVICES ON YOUR SYSTEM?:! 

ENTER DEMICE ADDRESSES: 

TNIS IS A SAMPLE PROGRAM FOR DEUICE 9 

FORMAT REQUESTED! OK TO DESTROY DATA ON DEVICE 0?Y 
THIS IS AN ASCII SAMPLE <SEQUENTIAL FILE) 
THIS IS A BINARY SAMPLE (RANDOM FILE) 



WHAT ARE RANDOM AND SEQUENTIAL FILES? 

All 4907 File Manager files cover specific areas of specific length on the disc recording 
surface. The location and size is specified in the CREATE command. There are two basic 
file forms — sequential and random. 



Sequential Files 

A sequential file may be pictured as a long empty space with no divisions: 

BEGINNING OF FILE 



File length specified 
in CREATE command 



Information is entered sequentially. This means it must start at the first empty space and 
work towards the end of allocated space. The first empty space may be at the beginning 
of the file or just past the last data entered. Information retrieval also must be sequential 
and must start at the beginning of the file. Sequential files are useful in storing entire 
programs or data items that are best accessed one after another. Sequential files may be 
generated on discs and 4051 mag tapes and discs. 
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Random Files 

A random file is similar to a sequential file except that it is divided into two or more 

sections or "records." 

Size and number of records 
specified in CREATE command 

BEGINNING OF FILE SIZE AND NUMBER OF RECORDS 

1 SPECIFIED IN CREATE COMMAND 



RECORD 

#1 



These records, which may be as small as one byte in length, are numbered. Information 
may be entered into or retrieved from any record in the file by specifying that record 
number in the I/O command. This means that data as small as a single character or 
number may be written or read or printed or input immediately without a sequential 
search. Data in each record cannot be "added to." Each time new information is entered 
into a record, it completely replaces existing information. Information in all other records 
in the file, however, remains unchanged. 

Random files may be created only on 4907 File Manager discs. They cannot be generated 
on the 4051 internal mag tape. 



NOTE 
Files are specified random or sequentiai in tlie CREATE statement 

SPECIAL SYSTEM FEATURES 

Special 4907 File Manager features are listed below with the associated commands. See 
COMMAND DESCRIPTIONS (Section 5) for specific command details. 

System Clock 

When files are created, altered, or used, the date and time of the activity are automatically 

recorded for that file. 

The date and time of each disc formatting are recorded on the volume label. 

Command involved: 

CALL "SETTIM" 
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Automatic File Extending 

Whenever data is sent to a file requiring more than the allocated space, the system 
automatically extends the file if the file has been defined to allow this. 

Commands involved: 

WRITE 
PRINT 
SAVE 



Status Messages 

Whenever it is necessary to check the status of a file or device, special commands may 
be executed which return status messages. These messages included time/date 
information, space specification, identification, etc. See DEVICE AND FILE STATUS 
MESSAGES (Appendix A). 

Commands Involved: 

CALL "CUSTAT" 
CALL "FILE" 
CALL "MOUNT" 
CALL"DSTAT" 
DIRECTORY 
OPEN 

Special Characters 

Special characters in the file identifier can simplify the search for files or groups of files. 
They are also useful in accessing certain kinds of libraries. See SPECIAL CHARACTERS 
IN FILE IDENTIFIERS in Section 4. 



4907 FILE MANAGER OPERATOR'S @ 2-19 



GENERAL OPERATION 



"Group" Open/Next File 

Many times it is necessary to access several files consecutively. Normally, this would 
require an individual OPEN for each file. However, with the use of SPECIAL CHARAC- 
TERS, groups of files may be selected, opened, and used with a single OPEN. This kind of 
OPEN command is called a "GROUP" OPEN and requires that a "G" is placed in the 
command. After the first file in the group is opened and used, CALL "NEXT" closes that 
file and opens remaining files one by one. 



Commands involved: 



OPEN 

CALL "NEXT" 



Free Space Message 

The amount of remaining storage space on any disc (in bytes) may be seen by requesting 
a device status message. 

Commands involved: 

CALL "OUST AT" 
CALL "DSTAT" 
CALL "MOUNT" 

Random Access 

Unlike files on mag tape, disc files may be created for random or "direct" access. This 
means that the file may be divided into numbered "sections" or records as small as one 
byte. By entering the number of that record in an I/O command it can be directly 
accessed without the need of stepping through the data items one by one. This can 
greatly speed I/O activities. 



Simultaneous File Use 

Once the system is notified which drive is to be accessed, up to 9 files may be opened 
and used. See OPENING MULTIPLE FILES in the OPEN command description. 

Commands involved: 

UNIT 

CALL "UNIT" 
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STORAGE STRUCTURE 



INTRODUCTION 

This section describes the concepts of file storage structures. It is necessary to 
understand these concepts to write file identifiers (F.l.s) which are necessary parts of 
many commands. 



WHAT IS A STORAGE STRUCTURE? 

When data or program information is sent to a disc, it is stored in a "file" that occupies a 
portion of the disc. Usually each file contains different information. Often, however, 
several files may contain similar information. As a result, it may be desirable to group files 
into categories, and then collect the categories into groups, and so on. This way it is 
easier to keep track of and recover all information. When one or more files are placed on 
the disc, or when file grouping is carried out, a "storage structure" is being formed. To 
illustrate what "storage structure" is and why it is a useful concept, we will start by 
showing a "storage structure" containing a single file: 
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Figure 3-1 . Sample Storage Structure (1 Level). 
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If another file were added, the structure would look like this: 




2380-15 



Figure 3-2. Sample Storage Structure (1 Level). 

So far we've shown two files stored on the "1 st level" of five storage levels provided by 
the system. If several files sharing a common characteristic or belonging to a particular 
user are to be added, they may be grouped under a "LIBRARY." If a library is used, the 
files will be placed on the next level; for example, three files grouped under a 1st level 
library will be placed on the 2nd level as shown below: 




1st level 



2nd level 
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Figure 3-3. Sample Storage Structure (2 Levels). 
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A library is a "heading" and can only be used to lead to other libraries or files on lower 
levels. A library can never be used to hold data or programs, nor can a file ever lead to 
another file or library. For example, if two groups of files were stored on the 5th level , 
there must be preceding libraries on the 4th, 3rd, 2nd and 1 st levels. The storage 
structure in Figure 3-4 shows what this might look like if these 5th level files were added 
to the sample storage structure in Figure 3-3. 




file 



library 



file 



library 



file 



file 



file 



library 



library 



file 



more files 
or libraries 



library 



library 



file 



file 



file 



file 



1 st level 



2nd level 



3rd level 



4th level 



5th level 
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Figure 3-4. Sample Storage Structure (5 Levels). 



Remember: 



1 . The only purpose of libraries is to allow grouping of files or libraries on subsequent 
levels. As a result, no libraries may be placed on the 5th level. 

2. Files never have subsequent files or libraries. 

3. There is no limit (other than space restrictions) to the number of libraries or files on a 
particular level. 

4. Storage structures are limited to five levels. 
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Section 4 
HOW TO WRITE A COMMAND 



INTRODUCTION 

ROM pack commands, like other 4051 BASIC commands, must be written in a specific 
manner. Each of the fields required for each command must be in proper order, and the 
information entered in those fields must be of the type specified in the description. 
Generally, each command contains one or more of the following fields in the order shown: 

KEYWORD and ADDRESS and/or ARGUMENT 

(or keywords) (or addresses) 



Keyword 

All commands require keywords. The keyword tells the system what kind of activity is to 
be carried out. The entry may be abbreviated as shown in the description of that 
command. Two keywords are required for some commands. Many keywords are preceded 
by the word CALL, which, while of no significance to the user, is required for system 
operation. The keywords preceded by CALL must always be in quotes; for example, CALL 
"DSTAT". 



Address 

The address tells the system the location of the device, the location of the file, or both. 
In some cases, two addresses are necessary because two devices or files are to be 
active. The different types of addresses required are shown below. 

device address This number, which must be an integer from to 255, tells the 

system which device it will be communicating with. It may or may 
not be the same device specified in the UNIT command. 

F.I. File identifier. This combination of names tells the system the 

location and identity of the file or files on the disc. 

HOW TO WRITE A FILE IDENTIFIER (later in this section) and 
STORAGE STRUCTURE (Section 3) provide discussion of F.I. 
requirements and storage structure. 
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Ifn Logical file number. The integer (from 1 to 9) entered here is 

specified in an earlier OPEN command and represents both 
the device address and the F.I. In some cases the Ifn must be 
preceded by # (pound sign). 

I/O address The I/O address tells the system what device, other than the 

4051 display, is to receive file status messages and what action 
is required. An I/O address may be specified only in the 
DIRECTORY command. 



Only the CALL "SETTIM", INIT, DELALL, CALL "OUST AT", CALL "FMVALS", SECRET, 
CLOSE, and CALL "TIME" commands do not require an address of some kind. This is 
because they set or reflect parameters affecting the entire system. 



Argument 

Those fields not containing keywords or addresses are considered "argument" fields. 
This means they must contain final information necessary for command execution. The 
argument may tell the system where to send the information that the command is 
generating, as in this example: 

CALL"DSTAT",2,A$ 

The last field, or argument, tells the system to send the device status message that this 
command generates to A$ in the 4051 storage memory. 

On the other hand, the variables in the argument may be used to supply information for a 
command execution rather than to store the results. 

Some commands, such as CALL "FORMAT", have many argument fields; others, such as 
CLOSE, may have none. 
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SYNTAX 

As you read the syntax forms in COMMAND DESCRIPTIONS (Section 5), you will see the 
fields are specified as one or more classes. An entry in any field must fit one of those 
classes. Each class is described below. 



Constant 

A constant entry must be a number (integer) and cannot be represented by a variable. 

String Constant 

A string constant entry must be the string required for that field and CANNOT be represented 
by a string variable (such as A$). All string constants must be shown with quotation 
marks ("DOCTORX") when entered in a command.'' In some cases, a choice between a 
few single character constants is necessary. Those choices will be shown instead of the 
term "string constant" within the brackets like this: 




Numeric Expression 

The numeric requirement for the field may be represented by any of the following: 
Numeric constant, such as 3 

Numeric variable, such as M 

Subscripted array, such as B(1),1 



Logical or relational comparison enclosed in parenthesis, such as, 

(A or B) 
(A> B) 

Valid combination of the above 



^ When a series of string constants are used in an F.I., only a single set of quotation marks around the 
entire F.I. is necessary. 
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Numeric Variable 



The entry may be any numeric variable allowed in regular 4051 operation. If a numeric 
variable is entered, it must represent the required number. 

String 

The entry may be a string ("DOG") or a string variable representing that string (A$). Any 
string must be preceded and followed by quotation marks when entered in either the 
command or stored in a string variable as shown here: 

A$ = "FINANCE" 



String Variable 

The entry may be any valid string variable allowed in regular 4051 operation (A$, B$). 

All string variables must be dimensioned if more than 72 characters are required to 
contain the information generated by the command. See the 4051 Graphic System 
Reference Manual. 

Target String Variable 

Usually, when string variables are used in a command, they already contain data to be 
used by that command— but not always. In some command descriptions you will see the 
term "TARGET STRING VARIABLE." In these cases the string variable is redefined at the 
time of command execution, and the data generated by the command is sent to this target 
string variable. 

The following command example is written with an integer, a string and, in the last field, a 
target string variable: 

CALL "FILE", 3,"MYLIBRY/FILE",A$ 
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The target string variable (A$) is the destination of the message generated by this 
command. Null strings {"") may be entered in the target string variable field to prevent file 
status messages from being stored. 

If the target string variable already contains data, it is replaced by the new data. 



Target Numeric Variable 

This term is used when numeric information generated by the command is sent to the 
numeric variable entered in that field. 



COMMAND DELIMITERS, PUNCTUATION AND SPACES 

special delimiters are required in F.l.s. See FILE IDENTIFIER DELIMITERS later in this 
section, for details on how they are used. 



Commas, Colons 
and Semicolons ,:; 



Act to separate fields. Their exact use Is shown with individual 
command descriptions. 



Quotation Marks " " 



Serve to tell the system that the enclosed data is a string 
constant which may be a single character or numeral, a string of 
alphanumerics, or a blank indicating a null string. 



Spaces 



Generally, spaces are ignored in command construction. Occa- 
sionally, however, they must be used as delimiters; for example, 
the system will return an error message if a SAVE command is 
written like this: 



SAVES; 100,500 
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The system has interpreted the E in E$ as part of the keyword. 
When it moves to read the F.I. field, all it will see is $ and an error 
condition will be created. The command must be written with a 
space, like this: 

SAVES; 100,500 



Trailing Dots . 



If a syntax or descriptive form is followed by trailing dots, the 
preceding field may be repeated as many times as desired. 



NOTE 



See SYNTAX in the 4051 Graphic System Reference Manual for further 
details. 



COMMAND EXAMPLES 



Command 


Example 


Result 


APPEND 


APP"@MYLIBRY/ 
A";1150,15 


Takes the entire program in file "A" in 
"MYLIBRY" and places it in memory 
starting with line 1 1 50 of the current 
program. Line numbers are to be in 
increments of 15. 


ASSIGN 


ASS"@YOURLIBRY/ 
MATH/STAT";"R" 


Changes the "STAT" file under libraries 
YOURLIBRY/MATH to a private status. 


CALL "COMPRS" 
(Compress) 


CAL"C0MPRS",1,1 


Collects space in files on device 1 not 
containing information as well as non- 
file space and groups it into larger 
contiguous blocks. 


CLOSE 


CLO 


Closes all files. 


COPY ... TO 


COP"@YOURLIB/ 
FRED/T0M",1 TO 
"@MYLIBRY/FRED/ 
T0M",2 


Copies file "TOM" from device 1 to 
device 2. If "MYLIBRY" and "FRED" do 
not exist on device 2, they are automat- 
ically created. 
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CREATE 


CRE"@MYLIBRY/ 
DAT A";'A";1 00,70 


Creates the file "DATA" on the library 
"MYLIBRY." The information is to be 
stored in ASCII in 1 00 records of 70 
bytes each. 


CALL "CUSTAT" 
(Controller Unit 
Status) 


CAL"CUSTAT",A$ 


Generates a status message for all 
devices interfaced to the controller and 
stores the message in the specified 
string variable. 


DIRECTORY 


DIR2,"@MYLIBRY/ 
GRADES" 


Locates the file "GRADES" in library 
"MYLIBRY", generates a "full" file sta- 
tus message, and displays it on the 
4051 screen. 2 indicates the format 
code. 


CALL "DISMOUNT" 


CAL"DISM0UNT",1 


Deactivates device 1 . Prevents system 
use of device until another CALL 
"MOUNT" is executed. 


CALL"DREL" 
(Device Release) 


CAL"DREL",2 


Releases exclusive control of device 2. 


CALL "DRES" 
(Device Reserve) 


CAL"DRES",2 


Reserves device 2. 


CALL "DSTAT" 
(Device Status) 


CAL"DSTAT",2,A$ 


Generates a device status message 
about device 2, as well as a status 
message on all open files. This mes- 
sage is stored in A$. 


CALL "DUP" 
(Duplicate) 


CAL"DUP",1,2,1 


Duplicates all information from device 1 
to device 2. All space, including unused 
file space, is collected into a contigu- 
ous space. 


CALL "FFRMT" 
(Fast Format) 


CAL"FFRMT",1, 
"LAB",1,1, 
"GENETICS", 
"BLUE",7,7,3,3,3 


Operates same as CALL "FORMAT" 
except no surface analysis is per- 
formed. This command is mainly for 
reformatting discs quickly. 
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CALL "FILE" 


CAL"FILE",2 

" MYLIBRY/MATH", 

A$ 


Generates file status message about 
file "MATH" in library "MYLIBRY" on 
device 2. Message is stored in A$. 


CALL "FMVALS" 
(File Manager Val- 
ues) 


CAU'FMVALS", A,A$ 


Sends the current device address to A 
and the name of the current library to 
A$. 


CALL "FORMAT" 


CAL"F0RMAT",1, 
"LAB",1,1, 
"GENETICS", 
"BLUE",7,7,3,3,3 


Formats a disc and creates a volume 

label with the following information: 

device address: 1 

volume identification: LAB 

volume number: 1 

number in series: 1 

owner's name or ID: GENETICS 

master password: BLUE 

1st through 5th level chains: 7,7,3,3,3 

Also conducts surface analysis and 
locates and records unusable space on 
the disc. This command is mandatory 
on new discs. 


CALL "HERRS" 
(Hard Error Status) 


CAU'HERRS", 
1AB,C,D 


Requests a count of the last I/O retries, 
the total I/O retries since last power up, 
number of successful recoveries, and 
number of unsuccessful recoveries. 
These all refer to device 1 . 

All numbers generated are stored in 
variables A, B, C and D, respectively. 


INPUT 


INP#3,40:A$ 


Reads the ASCII string in record 40 in 
Ifn 3 and stores it in A$. 


KILL 


KIL"@MYLIBRY#' 


Deletes all closed files in "MYLIBRY." 


CALL "MOUNT" 


CAL"M0UNT",1,A$ 


Activates device 1 for system use and 
generates device status message. Mes- 
sage is stored in A$. 
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CALL "MRKBBG" 
(Mark Bad Block 
Group) 


CAL"MRKBBG",2, 
"COLL","SECRET", 
"01 0001 FA" 


This command is executed only after a 
message specifying defective disc ar- 
eas appears. The command identifies 
the volume I.D. as "COLL" with a master 
password of "SECRET" on device 2. 
The address of the defective area is 
"01 0001 FA." 


CALL "NEXT" 


CAL"NEXT",3,A$ 


Closes the current file and opens the 
next file in a series specified by an 
OPEN "G" (group) command. This com- 
mand assigns the Ifn 3 to each file (in 
the group of files) as it is opened. 

CALL "NEXT" generates a new file 
status message with each new file, 
which is stored in A$. If A$ is returned 
"" as a null string, then no files remain 
in group. 


OLD 


OLD"$FINREC/ 
DEPTB" 


Locates the program file "DEPTB" in 
"SYSLIB/FINREC" and reads it from 
disc to 4051 memory. 


ON EOF 


ON E0F(2)THEN 165 


When end of file is encountered in the 
file represented by Ifn 2, system exe- 
cutes line 165. 


OPEN 


OPE"@UNIV/MAINT 
REC";1,"U", A$ 


Opens the file "MAINTREC" in library 
"UNIV" for updating. It also assigns 1 
as the logical file number which associ- 
ates this F.I. with the current device. 
This way when Ifn 1 is specified in 
subsequent commands, the system 
knows which file on which disc to 
access. 


PRINT 


PRI#3,40:A$ 


Prints the ASCII string in A$ to record 
40 in Ifn 3. 


READ 


REA#3,40:A$ 


Reads binary data in record 40 in Ifn 3 
and stores it in A$. 
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CALL "RENAME" 


CAL"RENAME",1, 

"PERSONNEL/ 

MGRS/JONES", 

"PERSONNEL/ 

MGRS/SMITH" 


Renames the file "JONES" under librar- 
ies "PERSONNEL/MGRS" on device 1 
to "SMITH." 


CALL "REWIND" 


CAL"REWIND",1 


Rewinds pointer on the file associated 
with Ifn 1 in an earlier OPEN command 
to beginning of file. 


SAVE 


SAV" B10/ 
CHEMSTAT"; 100,- 
3150 


Transfers a current program to the file 
"CHEMSTAT" in library "BIO" starting 
with line 1 00 and ending with line 31 50 
in binary format. If no file exists, the 
command automatically creates it. 


SECRET 


SEC 


Prevents future program listing. 


CALL "SETTIM" 
(SET TIME) 


CAU'SETTIM", "04- 
JUL-78 16:30:20" 


Sets system clock to 20 seconds after 
four-thirty PM on July, 4, 1978. 


CALL "SPACE" 


CAU'SPACE", 3, 
3000, A,B 


Adjusts file space to 3000 bytes on the 
file identified as Ifn 3 in an earlier 
OPEN command. Also generates two 
messages: the actual number of bytes 
required to store data and the actual 
number of bytes allocated. These mes- 
sages are stored in A and B, respec- 
tively. 


CALL "TIME" 


CAL"TIME",A$ 


Sends the current system time to A$. 


TYP (function) 


T=TYP(2) 


Performs type function on file associ- 
ated with Ifn 2. 

See TYP command description in the 
4051 Graphic System Reference 
Manual. 


UNIT 


UNI3 


Specifies device 3 as the current 
device. 
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CALL "UNIT" 


CAL"UNI",B 


Specifies the device address in B as 
the current device. 


CALL"USERLIB" 


CAU'USERLIB", 


Causes "PORTLAND/INDUSTRY" to be 


(User Library) 


"PORTLAND/ 


the current library. Unless this current 




INDUSTRY" 


library is circumvented with special 
characters, the system will attempt to 
locate all files in "PORTLAND/INDUSTR 


WRITE 


WRI#3,40:A$ 


Writes the binary string in A$ to record 
40 in Ifn 3. 
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HOW TO WRITE A FILE IDENTIFIER 

What is a File identifier? 

In STORAGE STRUCTURE (Section 3), we described libraries and files. Now we are going 
to discuss how a file identifier, or F.I., is used to create and access those libraries and 
files. 

An F.I. is a collection of one to five names that tells the system: 

the name and location of a file to be created 

or 

the name and location of an existing file 

Whether the F.I. is used to create a new file or locate an existing file depends on the kind 
of command in which it is placed. The F.I. is useless by itself. It^ must go inside a 
command. 

Every file has its own F.I., and no two files have exactly the same F.I. unless they are on 
different discs. 

Each F.I. contains one to five names^ that represent storage levels. For example, if you 
execute a command containing an F.I. of only one name like this: 

"BOB" 

then you can create or locate a storage structure consisting of one 1 st level file, as shown 
in Figure 4-1 : 




1 st level 



Figure 4-1. Sample Storage Structure (1 Level, 1 File). 



^ Or a logical file number representing the F.I. 

^ Exclusive of passwords and extensions described later. 
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If you enter an F.I. of five names like this: 

"W/X/Y/Z/DATA" 

then you can create or locate a storage structure consisting of one 5th level file and four 
libraries on the preceding four levels as shown in Figure 4-2. 




1 St level 



2nd level 



3rd level 



4th level 



5th level 



Figure 4-2. Sample Storage Structure (5 Levels, 1 File). 
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More files may be created or located anywhere on any existing storage structure by 
entering additional F.l.'s. For example, by executing: 

"W/SUM/DATA" 

"M/PROJ/BOB" 

"W/X/Y/Z/SUMS" 



in individual CREATE commands, the libraries SUM, M, PROJ and the files DATA, BOB, 
and SUMS will be added to the existing storage structure as shown in Figure 4-3. 














DATA 




SUMS 



1 St level 



2nd level 



3rd level 



4th level 



5th level 



Figure 4-3. Sample Storage Structure (5 Levels, 4 Files). 



2380-20 
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File Identifier Construction 

In WHAT IS A FILE IDENTIFIER? we discussed how F.l.'s are used in various commands 
to create or identify files and their locations. This section tells you how to write an F.I. to 
insert into those commands. The syntax and descriptive forms as well as specific field 
definitions describe the required F.I. construction. Delimiters are discussed later in FILE 
IDENTIFIER DELIMITERS. 

Remember, the basic purpose of an F.I. is to tell the system where a file is to be created or 
later, where it may be found; THE F.I. CAN ONLY DO THIS IF IT IS ENTERED INSIDE A 
COMMAND. The five "name" fields shown in Figure 4-4 represent, left to right, the first 
through fifth possible storage levels. 

The small number below a name field shows what level that field represents. The entry in 
that field lets the system know the name of the library or file that is to be created or found 
at that level. 



SYNTAX FORM 


f& \ I 


— 


— r 


- 


— ~ 


— 








[constant] 


string 
constant 
1 


string 
^ constant 
2 


string 
' constant ' 
3 


string 
' constant 
4 


string 
'constant 
5 










DESCRIPTIVE FORM 


name of 
[@] library 
or file 
1 


name of 
/ library 
or file 
2 


name of 
/ library 
or file 
3 


name of 
/ library 
or file 
4 


/ name of 
file 

_ 5 _ 
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Figure 4-4. Syntax and Descriptive Form of F.I. (File Identifier) Construction. 
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Field Descriptions (Descriptive Form) 

@(The Commercial "at" Sign) 

The "@" is used to circumvent tine "current library." See USERLIB String Suppression 
in this section and the CALL "USERLIB" command description in Section 5. 



1 . Name of Library or File 

The entry here specifies the name of the 1 st level library or file. For convenience, 
these libraries fall into groups named SYSLIB, USERLIB, or SCRATCHLIB. Each group 
is accessed differently. See USE OF 1 ST LEVEL LIBRARIES following these field 
descriptions. 



2. Name of Library or File 

The entry here specifies the name of the 2nd level library or file. The name may be 1 
to 10 characters long. The first character must be alphabetic, the rest alphanumeric. 



3. Name of Library or File 

The entry here specifies the name of the 3rd level library or file. The name may be 1 to 
10 characters long. The first character must be alphabetic, the rest alphanumeric. 



4. Name of Library or File 

The entry here specifies the name of the 4th level library or file. The name may be 1 to 
1 characters long. The first character must be alphabetic, the rest alphanumeric. 

5. Name of File 

The entry here specifies the name of the 5th level file. Since this is the "lowest level," 
all entries here must be files. The character requirements are the same as for the 
above fields. 
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USE OF 1ST LEVEL LIBRARIES 

There are three types of 1 st level libraries: 



SYSTEM LIBRARY 
(SYSLIB) 



USER LIBRARY 
(USERLIB) 



SCRATCH LIBRARY 
(SCRATCHLIB) 



SYSLIB: This library may be used to contain programs for system control, such 

as data acquisition. It also may be used for commonly accessed 
public programs for math or statistics work. There is only one system 
library, but it can be as large as an entire disc. 

USERLIB: These libraries may contain files usually restricted to a particular 

user, public files for a variety of users, or a combination of the two. 
There is no limit to the number of user libraries a user may create, 
and each may be as large as an entire disc. Every user library created 
must have a different name. 

SCRATCHLIB: This library may contain information, sample programs, etc. This is 
the default library. Unless directed otherwise, the system will always 
access this library for file creation or selection. There is only one 
scratch library but it may be as large as an entire disc. 

Each type of 1 st level library may be addressed as shown below: 



SYSLIB: Enter the $ followed by the rest of the libraries and file names. 

Example: "$A/B/C" (which is the same as "SYSLIB/A/B/C"). This will 
suppress the current or default library. 

USERLIB: Enter " @" then the name of the user library then the rest of the library 

and filenames. 

Example: " @MYLIBRY/A/B/C". This will suppress the current or default 
library. 

SCRATCHLIB: Leave out the name of the 1 st level library, SCRATCHLIB, then enter the 
rest of the library and filenames. 

Example: "A/B/C". 



4907 FILE MANAGER OPERATOR'S 



4-17 



HOW TO WRITE A COMMAND 



The system will always default to the scratch library if there is no other 
current library. If there is a current library, it must be suppressed this 
way: 

" @SCRATCH/A/B/C" 



NOTE 



It is important to remember ttiat ttiese groups are for convenience oniy. 
Any or aii data may be piaced in any one of tine above categories. 



Examples 

The following examples illustrate how to write F.l.'s for creating or locating files in 
SYSLIB, USERLIB and SCRATCHLIB storage structures* To see how characters are 
used as delimiters in F.I. construction, see FILE IDENTIFIER DELIMITERS in this 
section. 



SYSLIB 

Examples 1 through 3 show how F.l.'s should be written for the "SYSLIB" storage 
structure (Figure 4-5). These F.l.'s circumvent any current library. This means the 
system will not look in the current library for the file. 



Example 1 : 

"$PET/DOG/HUNTING/LAB" 

This example locates SYSLIB (by using the $) then libraries "PET," "DOG" and 
"HUNTING" in succession. The file "LAB" is accessed last. 



^"Storage structure" means all libraries and files under these 1 st level libraries. 
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Figure 4-5. Sample Storage Structure (5 Levels, 7 Files). 



Example 2: 



"$FOOD" 



This example locates the file "FOOD" in "SYSLIB." 



Example 3: 



If the statement 



A$ 



A$ = "$FOOD" 



is executed previously, the same file as in example 2 will be located if A$ is 
entered in the F.I. field. Although this file is on the 2nd level, it has no subsequent 
files and is, therefore, a "lowest level" file. 
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USERLIB 

The following examples show how F.l.'s should be written for the "MYLIBRY" storage 
structure in Figure 4-6. 

Examples 4 and 5 show how F.l.'s are written to circumvent the current library. 
Examples 6 and 7 show how to write F.l.'s when "MYLIBRY" is the current library. 



FIRE 




MYLIBRY 



INSURANCE 



TAXES 



HEALTH 



FEDERAL 



STATE 



INCOME 



EXCISE 



INCOME.PERS 



PROPERTY 



INCOME.CORP 



Figure 4-6. Sample Storage Structure (4 Levels, 7 Files). 



Example 4: 



" @MYLIBRY/T AXES/FEDERAL/EXCISE" 



This example specifies the file "EXCISE" in libraries "MYLIBRY," "TAXES," and 
"FEDERAL." The @ is necessary to circumvent the current library. 



Example 5: 



"@MYLIBRY/TAXES/STATE/INCOME.CORP" 



This example specifies the file "INCOME" (with the extension ".CORP") located in 
libraries "MYLIBRY," "TAXES," and "STATE." The @ is necessary to circumvent 
the current library. 
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Example 6: 



"INSURANCE/FIRE" 



This example specifies the 2nd level library "INSURANCE" in "MYLIBRY" then 
searches for the file "FIRE." No 1 st level entry is necessary because MYLIBRY 
was specified in the CALL "USERLIB" command as the current library. 



Example 7: 



If the statement 



C$ 



C$ = "INSURANCE/FIRE" 

is executed earlier, C$ will select the same file as Example 6 when entered into 
the F.I. field in the command. 



SCRATCHLIB 

The following examples show how an F.I. must be written for the sample scratch 
library in Figure 4-7. 



AMP 



V220 



V125 




SCRATCHLIB 



DATA 



WATT 



V250 



VOLT 



VI 25 



V250 



Figure 4-7. Sample Storage Structure (4 Levels, 5 Files). 
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Example 8 shows how an F.I. must be written to access a file in SCRATCHLIB (the default 
library). 

Example 9 shows how to write an F.I. to SCRATCHLIB when there is a current library. 



Examples: 

"DATA/VOLT/V250" 

This example locates file "V250" in libraries "DATA" and "VOLT" in the current 
default library "SCRATCHLIB." 

Example 9: 

"@SCRATCHLIB/DATA/AMP/V1 25" 

In this example, the first entry (©SCRATCHLIB) circumvents the current library 
and sends the system to the scratch library. The file "VI 25" is then located. This 
example shows how to locate the scratch library when it is not the default library. 

Using Passwords in File Identifiers 

Passwords may be assigned to any library or file to prevent unauthorized access. When 
attempts are made to access the file, the password or passwords must be entered in the 
F.I. with the file and library names, or access will be prevented or restricted.^ 

How to Write a Password 

Passwords are specified in F.l.'s along with library names, file names and extensions. The 
password must immediately follow the name of the library or the name of the file, and 
must be separated by a colon (:). The format is shown below: 

library or file name:password 

A password may be 1 to 1 characters long. The first character must be alphabetic, the 
rest alphanumeric. 



^Unless a master password is used. See CALL "FORMAT" command description in Section 5. 
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EXAMPLE: 

Assume that a new file name "SALARIED" along with the password "BOSS" is to be 
created in an existing storage structure under a 1st level library "PERSONNEL." The F.I. 
in the CREATE command must be written this way: 

" @PERSONNEL/SALARIED:BOSS" 

If the existing structure looks like this: 




Figure 4-8. Sample Storage Structure (2 Levels, 1 File). 



the F.I. will result in the revised storage structure shown in Figure 4-9. 
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BENEFITS 




SALARIED:BOSS 



Figure 4-9. Sample Storage Structure (2 Levels, 2 Files, 1 With Password). 
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Remember that: 

• A password cannot be assigned to the "PERSONNEL" library because it existed 
before this new F.I. was written. 

• A file name password can be changed by executing a CALL "RENAME" command 
if the original password is specified in the command. Library passwords cannot be 
changed. 

How Much Access? 

Specifying a //'torary password prevents any future access to subsequent files unless that 
password is used. 

The degree of access to a file, however, is dependent not only on the use of a password 
but also on the attribute assigned to the file in the CREATE command. An "R" must be 
assigned to a file if it is to be private. A "U" must be assigned if the file is to be public. 

The chart below shows how public and private file status is affected by use or nonuse of 
an assigned password. 





When "U" (public) is 


When "R" (private) is speci- 




specified as an attribute, 


fied as an attribute, these 




these commands may be 


commands may be executed. 




executed. 




When specified pass- 


READ OLD 


READ OLD 


word is supplied: 


WRITE SAVE 


WRITE SAVE 




PRINT KILL 


PRINT KILL 




INPUT RENAME 


INPUT RENAME 




APPEND COPY... TO 


APPEND COPY... TO 


When specified pass- 


READ INPUT APPEND 


No access allowed 


word is not supplied: 


OLD 





4-24 



4907 FILE MANAGER OPERATOR'S 



HOW TO WRITE A COMMAND 



Extensions 

The extension allows the program to distinguish between similar, but not identical, files by 
acting as a label or tag on the end of the name of the file. 

EXAMPLE: 

File: VEG 

Files with extensions: VEG.PER or VEG.ANN 

An extension may be specified for any file, but an extension is never assigned to a library. 
The extension may be 1 to 4 characters long. The first character must be alphabetic, the 
rest alphanumeric. 

The sample storage structure in Figure 4-1 and the description following it show how 
extensions are used: 






DEPT5 




1st level 




































WILLCALL 




INVENTORY 




2nd level 




































HARDWARE 




GARDEN 




3rd level 












































1 






SUPPLIES 




TOOLS 




TOOLS 




SEEDS 




4th level 












































VEG.PER 




VEG.ANN 


5th level 




















2380-28 



Figure 4-10. Sample Storage Structure (5 Levels, 6 Files). 
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This structure shown in Figure 4-1 includes files WILLCALL, SUPPLIES, TOOLS, 
TOOLS, VEG.PER and VEG.ANN. All the other entries are libraries. Since there are six 
files in this structure, six F.l.'s were required to construct it. Notice the extensions "PER" 
and "ANN" were added onto the "VEG" files. This is to allow the 4051 to distinguish 
between them when only one is to be accessed. You may have noticed that no extensions 
were specified for the files named "TOOLS". This is because they are under different 
libraries. Once the 4051 reaches either "HARDWARE" or "GARDEN" in its search for a 
"TOOLS" file it is unaware that there is another "TOOLS" file anywhere else. As a result, 
no extensions are necessary. 



File Identifier Delimiters 

The slash (/) is used to separate name fields. 
EXAMPLE: 

@ MYLIBRY/A/B/C/D 
The colon (:) is only used to separate a password from a library name or file name. 
EXAMPLE: 

@ MYLIBRY/A/B/C/D:PASS 
The period (.) is only used to separate an extension from the rest of the file name. 
EXAMPLE: 

@ MYLIBRY/A/B/C/D:PASS.EXT 
OR 
@ MYLIBRY/A/B/C/D.EXT 
Quotation marks ("") are used to enclose the entire F.I. 
EXAMPLE: 

"@ MYLIBRY/A/B/C/D.EXT" 
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General Delimiter Information 

No spaces may be included in F.l.'s. 

No delimiters can be used in an F.I. except those specified here. 



QUOTES MUST APPEAR NO QUOTES 

OUTSIDE F.I. NO SPACES ANYWHERE WITHIN F.I. 

\ / \ / 

" OMYLIBRY/ ST. 'JOHNS/ DOCTOR'.S/"YOURS"/FILE;PASS" 

/ / \ / 

NO SPACE NO PERIODS EXCEPT NO APOSTROPHES NO SEMICOLONS 

THOSE PRECEDING 
EXTENSIONS 



SPECIAL CHARACTERS IN FILE IDENTIFIERS 

In HOW TO WRITE A FILE IDENTIFIER we discussed exactly how F.l.'s must be written. 
That information described how to write an F.I. for a single file. An F.I., however, may be far 
more useful with the addition of special characters. 

The special characters are the pound sign (#), the asterisk (*), the question mark (?), the 
commercial "at" sign (@), and the dollar sign ($). 

Special or Multiple File Selection {W) (*) (?) 

The following commands can be written to locate more than just a single file: OPEN, 
DIRECTORY, KILL, COPY ... TO, CALL "RENAME," CALL "FILE." By using special 
characters you can write commands that will find: 

• All files on all levels below any 1 st level library. 

• All files on any single level. 

• All files with common names, common prefixes or common extensions on any 
single level. 

The files involved will be chosen in order of their hashing address. Only "eligible" files 
will be selected, and files are eligible only if: 

• Passwords are entered completely and correctly. 

• Device or disc is not write protected. 

• The MOUNT command has been executed. 
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Pound Sign (#). The pound sign selects all eligible libraries and files at the level the 
character is entered as well as all libraries and files at subsequent levels. 



Limitations: 

1 . Only one " #" may be used in any F.I. 

2. Slash marks (/) cannot be used immediately adjacent to a "#". The exception is the 

slash marks assigned automatically in the CALL "USERLIB" command since the 
slash mark in this instance is "invisible" to the "#." 

3. Only one file level (with an optional extension) may be specified to the right of a "#." 



EXAMPLES: 



These examples show the use of the " #' in an F.I. 



Assume "MYLIBRY" is the current library. 



Example 1 : 



"# 



This example locates all files in "MYLIBRY" as shown in Figure 4-1 1 




1 St level 



2nd, 3rd, 4th, 5th levels 



2380-27 



Figure 4-11. Sample Storage Structure (2 Levels). 
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Example 2: 



"A# 



This example locates all files on the 3rd, 4th and 5th levels in library "A" as shown in 
Figure 4-1 2. 




MYLIBRY 



LIBRARY A 



1 St level 



2nd level 



All Files 



3rd, 4th, 5th levels 



Figure 4-1 2. Sample Storage Structure (3 Levels). 
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Example 3: 



"A/B^" 



This example locates all files on the 4th and 5th levels below library "B" as shown in 
Figure 4-13. 




1 St level 



2nd level 



3rd level 



4th, 5th levels 



Figure 4-1 3. Sample Storage Structure (4 Levels). 
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Example 4: 



"A/B/C#" 



This example locates all files on the 5th level below libraries "A," "B," and "C" as 
shown in Figure 4-1 4. 




MYLIBRY 



LIBRARY A 



LIBRARY B 



LIBRARY C 



All Files 



1 St level 



2ncl level 



3rd level 



4th level 



5th level 



Figure 4-14. Sample Storge Structure (5 Levels). 
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Example 5: 



"A/B#.BLUE" 

This example locates all files under library "B" with the extension "BLUE". All other 
files in the storage structure with the extension "BLUE" will be ignored. 



RCH.BLUE 




MYLIBRY 



MATH.BLUE 



LIBRARY A 



LIBRARY B 



DATA.BLUE 



CALC.BLUE 



LIBRARY C 



LINE.BLUE 



INS.BLUE 



1 St level 



2nd level 



3rd level 



4th level 



5th level 



Figure 4-1 5. Sample Storage Structure (5 Levels). 
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Asterisk(*). The asterisk may be used three ways: 

1 . To select all eligible libraries or files at the level or levels the character is 
entered. 

2. To select all eligible libraries or files v/Wh a particular prefix. 

3. To select all files using extensions with a particular prefix. 
Limitations: 

1 . An asterisk locates only those libraries or files within a single level. All names on 
preceding and subsequent levels must be specified. If no subsequent names are 
specified, only files at the asterisk level will be selected. 

2. An asterisk cannot be used to locate a file or library with a password. 

3. Characters in a name cannot be used to the right of an asterisk; for example, 
"DO*" is legal but "D*N" is not. 

EXAMPLES: 

Examples 1 through 4 show how to locate all eligible libraries or files at the level the 
character is entered. Examples 5 through 7 show how to locate a file, library or extension 
with a particular prefix. Examples 5 through 7 are not whole F.l.'s but typical entries 
usable at any level. Assume that MYLIBRY is the current library. 
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Example 1 : 



"VB/C" 



This example locates all files named "C" under any 3rd level library named "B" 
which is under ANY 2nd level library. 




LIBRARY X 



LIBRARY Y 

























LIBRARY A 




LIBRARY B 


















1 












1 








FILEC 




FILEF 




FILED 




FILEE 



LIBRARY A 



LIBRARY B 



FILEC 



FILEG 



FILEH 



1 St level 



2nd level 



Srd level 



FILE C 4th level 



Figure 4-1 6. Sample Storage Structure (4 Levels, 8 Files). 
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Example 2: 



"A/VC" 



This example locates any file named "C" under ANY 3rd level library which is under 
2nd level library "A" in "MYLIBRY." 



Example 3: 



"A/B/*" 



This example locates all 4th level files in the 3rd level library "B" which is under the 
2nd level library "A." 



Example 4: 



"A/B.*" 



This example locates all 3rd level files "B" with any extension under 2nd level library 
"A." The arrows in Figure 4-1 7 show these files. 



I disc j 



MYLIBRY 



LIBRARY A 



B.TOM 



LIBRARY X 



A.TOM 



B.RED 



nr^n 



B.RED 



B.TOM 



1 St level 



2nd level 



3rd level 



t 



t t 
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Figure 4-1 7. Sample Storage Structure (3 Levels, 7 Files). 
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Example 5: 



This example locates any library or a single file with the first letter of "A" such as 
these: 

AB 
A1 
AABCO 

Example 6: 

A*.RED 

This example locates any file with the first letter "A" and the extension "RED". 
Remember that extensions cannot be assigned to library names. 

Example 7: 

JUMP* 

This example locates any library or file with the prefix "JUMP" such as these: 

JUMPING 

JUMP 

JUMPY 
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Question Mark (?). The question mark may be used to replace single characters when 
specifying library names, file names or extensions. 



Limitations: 

The question mark cannot represent more than a single character. 

EXAMPLES: 

These examples are not complete F.l.'s but typical entries using the "?" which may be 
employed at any level. SCRATCHLIB is the current library. 

Example 1 : 

? 

This example locates any library or file with a name one character in length. 

Example 2: 

???? 

This example locates any library or file name one, two, three or four characters in 
length. 

Example 3: 

???/??? 

This example locates all library names on one level which are one, two, or three 
characters long with any file on the next level with a name one, two, or three 
characters long. 
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Example 4: 



CA7/C0? 



This example locates all library or file names on one level with two or three characters 
beginning with "GA" with any file name on the next level with two or three characters 
beginingwith "CO." 



The example will locate: 



This example will not locate: 



CA/CO 

CA/COW 

CAT/CO 

CAB/COT 

CAT/COW 

CAR/CON 

CAP/COB 



CATT/COWE 

CATT/COW 

CAT/COWE 

CAB/KING 

CA/COWE 

CATT/CO 

C/C 

C/COW 

CAT/C 



USERLIB String Suppression (@) 



When a string representing the first part of an F.I. is entered with a CALL "USERLIB" 
command, that portion is accessed and placed in front of any F.I. in subsequent 
commands. This portion is called the current library, and its purpose is to reduce the 
amount of work and space in accessing files In subsequent commands. 

However, it is not always desirable to access a file in the current library. To circumvent 
the current library, a commercial "at" sign (@) must precede the F.I. By using the "@," the 
system will access any other library named in the F.I. 
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EXAMPLES: 

1 00 CALL "USERLIB","YOURLIBRY" 

250 OPEN "@ MYLIBRY/A/B";3,"F",A$ 

300 OPEN "L/M";2,"F",B$ 

When line 1 00 is executed, "YOURLIBRY" is specified as the current library. 

When line 250 Is executed, the system accesses "MYLIBRY" because of the "@" In the 
F.I. and ignores the current library, "YOURLIBRY". 

When line 300 is executed, the system automatically accesses the current library, 
"YOURLIBRY," and locates 1st level library "L" and 3rd level file "M." 

Remember: 

• The "@" must be used to access a user library UNLESS that library Is the current 
library. 

• The default current library Is SCRATCHLIB. 

• The " @" also can be used to create or access a 1 st level file In the same way It 
creates or accesses a library. 



Simplified SYSLIB Access ($) 

There are three ways to access SYSLIB (system library): 

1 . Enter SYSLIB Into a CALL "USERLIB" command. The $ should not be used In a CALL 
"USERLIB" command. 

2. Enter an "@ " as the first character in an F.I. followed by "SYSLIB" and the balance of 
the F.I. 

3. Enter a "$" (which reads "SYSLIB" to the 4051 ) as the first character in an F.I. 
followed by the balance of the F.I. No slash mark (/) is necessary after entering the $. 

When method 2 or 3 Is employed, the current library is Ignored. 



4907 FILE MANAGER OPERATOR'S @ 4-39 



SECTION 5 



4907 FILE MANAGER OPERATOR'S 



CONTENTS 



Introduction 5-1 

How to Read Command Descriptions 5-1 

Format 5-2 

Purpose 5-2 

Syntax Form 5-2 

Descriptive Form 5-3 

Field Definitions 5-3 

General Information 5-3 

Prerequisites 5-3 

Examples 5-3 

System Commands 5-5 

Controller/Device Commands 5-19 

File Management Commands 5-43 

File I/O Commands 5-89 



4907 FILE MANAGER OPERATOR'S 



Section 5 
COMMAND DESCRIPTIONS 



INTRODUCTION 

This section explains how to read command descriptions. It then describes all commands 
unique to the 4907 File Manager. 

HOW TO READ COMMAND DESCRIPTIONS 

4907 File Manager commands have been grouped into the following four categories: 

1. SYSTEM COMMANDS 

2. CONTROLLER/DEVICE COMMANDS 

3. FILE MANAGEMENT COMMANDS 

4. FILE I/O COMMANDS 

The following is a brief definition of each category. Read through it before proceeding 
the individual commands. 

1. SYSTEM COMMANDS 

These commands affect the entire 4907 File Manager system. They include 
commands that set the system clock, the current device, the current library and more. 

2. CONTROLLER/DEVICE COMMANDS 

These commands activate and deactivate the drive, format the disc, etc. These are 
basically preparatory commands, and, therefore, affect file management and I/O only 
indirectly. 

3. FILE MANAGEMENT COMMANDS 

These commands create, rename, enlarge, reduce and reserve files as well as carry 
out many other file activities. 

4. FILE I/O COMMANDS 

These commands are used to place information into or retrieve information from files. 
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Format 

The individual command descriptions are divided into the following parts: 

Purpose 
Syntax Form 
Descriptive Form 
Field Definitions 
General Information 
Prerequisites 
Examples 

Occasionally, extra information will be added to a command description to help a user 
with its execution; for example, HOW LARGE SHOULD FILES OR FILE RECORDS BE? is 
included in the CREATE command description. 

Purpose 

This section explains the function of the command. 

Syntax Form 

The syntax form shows the number of fields, delimiters and punctuation required. 
However, for simplicity, the required quotation marks are generally not shown in the 
syntax form (except for keywords which do show quotes). Remember, quotation marks are 
required for all strings and string constants. See the examples in the command 
descriptions. 

The syntax form also shows either the exact entry or class of entry required (constant, 
string constant, numeric expression, numeric variable, string, string variable, target string 
variable, target numeric variable). Although a file identifier may be represented as a string 
or string variable, it is always shown in the syntax form as F.I. For more details see HOW 
TO WRITE A COMMAND (Section 4). 

Brackets and braces are shown for the following reasons: 

Brackets [ ] indicate that the field is optional. Nested brackets [A[B]] indicate that while 
both fields are optional, the outside field (A) has priority and any entry must be made 
there first. 
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Braces { } indicate tliere is a choice between the terms, characters, classes or numbers 
within the braces. 

Braces and bracl<ets are shown in descriptive form for the same reasons. 



Descriptive Form 

After the complete keyword, this form provides a one or two word definition of the purpose 
of each field. 



Field Definitions 

This section gives a complete description of each of the fields shown in DESCRIPTIVE 
FORM. 



General Information 

Operational peculiarities for the command are described in this section. 

Prerequisites 

This section lists operations or commands that must be executed before executing the 
command being discussed. It may describe the condition that must exist before execution 
of the command. 

Examples 

This section shows examples of the command. In most cases a sample line number 
precedes the command. Some examples represent field contents with X's or N's. The use 
of commands, or statements in programs is demonstrated in INPUT and READ command 
descriptions as well as SAMPLE PROGRAMS (Appendix F), USING PRINT AND INPUT IN 
A PROGRAM (Appendix G), and USING WRITE AND READ IN A PROGRAM (Appendix H). 

NOTE 

Line numbers, though not always shown, can precede all commands 
described in this manual. 
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These commands affect the entire 4907 File Manager system. They include commands 
that set the system clock, the current device, the current library and more. 



DELALL (Delete All) 5-5 

CALL "FMVALS" (File Manager Values) 6-6 

INIT (Initialize) 5-8 

CALL "SETTIM" (Set Time) 5-9 

CALL "TIME" 5-11 

UNIT 5-12 

CALL "UNIT" .5-14 

CALL "USERLIB" 6-16 



@ 4907 FILE MANAGER OPERATOR'S 



COMMAND DESCRIPTIONS 
DELALL 



DELALL (Delete All) 



Purpose 



This command erases everything currently in the 4051 memory. 

This is a 4051 BASIC command, it is included here because its execution has a direct 
effect on system operation. 



SYNTAX FORM 

DEL ALL 

DESCRIPTIVE FORM 

DELETE ALL 



General Information 

Execution of this command closes all disc files, sets the current device to zero (0), and 
specifies "SCRATCHLIB" as the current library. 



Prerequisites 

None. 
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CALL "FMVALS" 



CALL "FMVALS" (File Manager Values) 

Purpose 

The CALL "FMVALS" command sends the number of the current device to the numeric 
variable specified and the name of the current library to the string variable specified. 
These values can be displayed by recalling the variables. 



SYNTAX FORM 



CAL "FMVALS", numeric variable, string variable 



DESCRIPTIVE FORM 



CALL "FMVALS", target numeric variable, target string variable 



Field Definitions (Descriptive Form) 



CALL "FMVALS" 



These are the keywords for the command. They may 
be entered as shown in SYNTAX FORM. 



target numeric variable 



This is where the address of the current device is 
stored. 



target string variable 



This is where the name of the current library is 
stored. 
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General Information 

The current device is specified by tlie UNIT command. Tine current library is specified by 
the CALL "USERLIB" command. The defaults are for the device and SCRATCHLIB for 
the current library. 



Prerequisites 

None. 

Example 

1 00 CALL "FMVALS",A,A$ 
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INIT 



INIT (Initialize) 

Purpose 

This command resets all string variable, array variable, and numeric variable values to an 
undefined state. 

This is a 4051 BASIC command. It is included here because it has a direct effect on 
system operation. 



SYNTAX FORM 

INIT 

DESCRIPTIVE FORM 

INITIALIZE 



General Information 

Execution of this command closes all disc files, sets the current device to zero (0) and 
specifies "SCRATCHLIB" as the current library. 



Prerequisites 

None. 
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CALL "SETTIM" (Set Time) 



Purpose 



The CALL "SETTIM" command sets the system clock so the exact time and date may be 
recorded when files are created, used or altered. The system clock is also necessary to 
mark the exact time and date on the volume label when discs are formatted. 



SYNTAX FORM 



CAL "SETTIM", string 



DESCRIPTIVE FORM 



CALL "SETTIM", date and time 



Field Definitions (Descriptive Form) 



CALL "SETTIM" 



These are the keywords for this command. The entry may be 
made as shown in SYNTAX FORM. 



date and time 



The format for this field is: 

"DAY-MONTH-YEAR HOUR:MINUTES:SECONDS" 



Except for "month," which requires three characters, all sub- 
fields in this field may be one or two characters long. 

"DD-MOM-YY HH:MM:SS" 

For example, if the system clock is to be set at one minute and 
20 seconds past two PM on the fifth of January 1 978, the entry 
is written this way: 

"5-JAN-78 14:1:20" 

Note that the "time" subfields are based on the military time 
scale of 000 to 2400 hours. 

The syntax for this range is 0:0:0 to 23:59:59. 
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CALL "SETTIM" 



General Information 



NOTE 

The system clock must be operating whenever the system is being used. 
When the ciocl< has been set, the clocl< indicator on the controller front 
panel is out. The system clock must be restarted whenever the system is 
powered up. The time entered in the CALL "SETTIM" command must be 
accurate or certain commands such as CALL "RENAME" will not work 
correctly. 



The "seconds" subfield is optional. All characters entered past the seconds subfield are 
ignored. 

The first three characters of the word for that month must be entered in the month field. 

Entries must be made in both date and time fields. The command cannot enter dates later 
than 2040 A.D. 

The system generates a December 32 on non-leap years, but makes no provision for 
February 29 on leap years. 



Prerequisites 

None. 

Examples 

CALL"SETTIM","14-DEC-77 20:30" 

This example sets the system clock at thirty minutes past eight in the evening, December 
14,1977. 

CALL"SETTIM",A$ 

This example sets the system clock to whatever date/time specifications are stored in A$. 
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CALL "TIME" 



Purpose 



The CALL "TIME" command returns the current data and time, according to the system 
clock, to the string variable specified in the last field. 



SYNTAX FORM 



CAL "TIME", string variable 



DESCRIPTIVE FORM 



CALL "TIME", target string variable 



Field Definitions (Descriptive Form) 



CALL "TIME" 



target string variable 



These are the keywords for this command. 
They may be entered as shown in SYNTAX 
FORM. 

This is the location to which the 1 8 charac- 
ter time "message" is sent 



General Information 

If the system clock is not operating, a null string is sent to the return string variable. 

Prerequisites 

A previous execution of CALL "SETTIM" is necessary for an accurate message. 

Example 

CAL "TIME", A$ 
This example sends the current date and time, according to the system clock, to A$. 
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UNIT 



Purpose 

The UNIT command specifies tiie current device. Commands containing F.l.'s or Ifn's but 
no device addresses are directed to the current device. If no UNIT command is executed, 
the system designates device zero (0) as the current device. 



SYNTAX FORM 

UNI constant 

DESCRIPTIVE FORM 

UNIT device address 



Field Definitions (Descriptive Form) 



UNIT 



This is the keyword. It may be entered as shown in SYNTAX 
FORM. 



device address 



The device address may be seen on or near the front of the 
device. 



General Information 

The UNIT command must be executed each time the system is powered up if any device 
other than is to be the current device. 
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The following commands always attempt to execute on the current device specified by 
the UNIT command: 

APPEND 

ASSIGN 

CALL "NEXT" 

CALL "REWIND" 

CLOSE 

CREATE 

DIRECTORY 

INPUT 

KILL 

OLD 

OPEN 

PRINT 

READ 

SAVE 

WRITE 

If no UNIT command is executed, device zero (0) is considered the current device. 
The INIT, OLD and DELALL commands also reset the current device address to zero (0). 

Device zero (0) may or may not exist, depending on your system. This depends on the 
strapping procedures carried out when your system was installed. Your TEKTRONIX 
technician will identify the device addresses after installation. 



Prerequisites 

None. 

Example 

110 UNIT 2 
This example specifies device 2 as the current device. 



4907 FILE MANAGER OPERATOR'S (a) 5-13 



COMMAND DESCRIPTIONS 
CALL "UNIT" 



CALL "UNIT" 



Purpose 

The CALL "UNIT" command specifies the current device. Commands containing F.l.'s or 
Ifn's but no device addresses attempt to carry out their operation on the current device. 
If no CALL "UNIT" command is executed, the system designates device zero (0) as the 
current device. 



SYNTAX FORM 



CAL "UNIT", numeric expression 



DESCRIPTIVE FORM 



CALL "UNIT", device address 



NOTE 



This command functions exactly as the UNIT command. The only 
difference is that UNIT requires a constant in the device address field 
where CALL "UNIT" allows a numeric expression. 



Field Definitions (Descriptive Form) 



CALL "UNIT" 



These are the keywords. They may be entered as shown in 
SYNTAX FORM. 



device address 



The device address may be seen on or near the front of the 
device. 
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General Information 

The CALL "UNIT" command must be executed each time the system is powered up if any 
device other than is to be the current device. 

The following commands always attempt to execute on the current device specified by 
the CALL "UNIT" command: 

APPEND 

ASSIGN 

CALL "NEXT" 

CALL "REWIND" 

CLOSE 

CREATE 

DIRECTORY 

INPUT 

KILL 

OLD 

OPEN 

PRINT 

READ 

SAVE 

WRITE 

If no CALL "UNIT" command is executed, device zero (0) is considered the current 
device. 

The INIT, OLD and DELALL commands also reset the current device to zero. 

Device zero (0) may or may not exist, depending on your system. This depends on the 
strapping procedures carried out when your system was installed. 



Prerequisites 

None. 

Example 

120CALL"UNIT",B 
This example specifies the device address in B as the current device. 
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CALL ''USERLIB" 

Purpose 

The CALL "USERLIB" command specifies the "current library." This command makes 
repeated file access more convenient. 

The CALL "USERLIB" command places a portion of an F.I. in memory where it may 
automatically be recalled to precede the balance of the F.I. in subsequent commands. 
This portion is called the current library. 



SYNTAX FORM 



CAL "USERLIB", string 



DESCRIPTIVE FORM 



CALL "USERLIB", partial F.I. 



Field Definitions (Descriptive Form) 



CALL "USERLIB" 



These are the keywords for this command. They may be entered 
as shown in SYNTAX FORM. 



partial F.I. 



This entry may match up to the first 21 characters of the F.I. of 
the file to be accessed. All delimiters, (/), (:), (.), as well as 
passwords, must be included in the 21 character count. 



Names on only the first four of the five available storage levels 
may be entered in this field. 

If a string variable is entered in this field, it must also represent 
21 characters or less. 
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General Information 

A slash is automatically assigned to the end of the partial F.I. entered in this command. 
Even though it may be considered as a 22nd character, it is accepted by the system. 

The current library specified in a CALL "USERLIB" command may be circumvented by 
preceding an F.I. with a commercial "at" sign (@) or a dollar sign {$). See SPECIAL 
CHARACTERS IN FILE IDENTIFIERS in Section 4. 

Special characters {^, *, ?) should not be used in a CALL "USERLIB" command. 

END, INIT, OLD or DELALL commands disable a previous CALL "USERLIB" command. 
This automatically specifies SCRATCHLIB as the current library. 



Prerequisites 

None. 

Examples 

Example 1 : 

If several 4th level files below the same 3rd level library (PROJ) are to be repeatedly 
accessed, the names of the first three levels may be entered in a CALL "USERLIB" 
command. For example, if the F.I. of one of the files is 

"MYLIBRY/PROG/PROJ/DATA" 

then everything up to the name of the file, except the last slash (/), may be placed 
in a CALL "USERLIB" command in this way: 

1 1 CALL "USERLIB","MYLIBRY/PROG/PROJ" 
The only entry repeatedly required in the command accessing the file is "DATA". 
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Example 2: 



If many libraries and files under one particular 1 st level library are to be accessed, 
only the 1 st level library name can be part of a CALL "USERLIB" command. For 
example, if two F.l.'s used in a program look like this: 

"PRODUCER/PRICES/LIST" 

"PR0DUCER/SALESMEN/AREA1 " 

Then the CALL "USERLIB" command can only contain "PRODUCER" as shown 
below. 

1 50 CALL "USERLIB","PRODUCER" 

The F.l.'s used throughout the balance of the program must be written like this: 

"PRICES/LIST" 

or this: 

"SALESMEN/AREA1" 



5-18 @ 4907 FILE MANAGER OPERATOR'S 



CONTROLLER/DEVICE COMMANDS 

These commands activate and deactivate the drive, format the disc, etc. These are 
basically preparatory commands and therefore, affect file management and I/O only 
indirectly. 



CALL "COMPRS" (Compress) 5-19 

CALL "CUSTAT" (Controller Unit Status) 5-1 2 

CALL "DISMOUNT" 5-23 

CALL "OREL" (Device Release) 6-25 

CALL "DRES" (Device Reserve) 5-27 

CALL "DSTAT" (Device Status) 5-29 

CALL "FFRMT" (Fast Format) 5-31 

CALL "FORMAT" 5-32 

CALL "HERRS" (Error Status) 5-36 

CALL "MOUNT" 5-38 

CALL "MRKBBG" (Mark Bad Block Group) 5-40 
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CALL "COMPRS" (Compress) 



Purpose 



The CALL "COMPRS" command collects unused spaces on a disc into one contiguous 
space. You have the option of reducing existing file space on each file to exactly fit stored 
data or programs. This makes more space available for new files. 



SYNTAX FORM 



CAL "COMPRS", numeric expression, numeric expression 



DESCRIPTIVE FORM 



CALL "COMPRS", device address, compress control 



Field Definitions (Descriptive Form) 



CALL "COMPRS" 



These are the keywords for this command. Entry may be made 
as shown in SYNTAX FORM. 



device address 



The device address may be seen on or near the front of the 
device. 



compress control 



When 1 is entered, the system collects and groups all space not 
already occupied by data or programs regardless of whether or 
not that space is formatted as file space. When is entered, the 
system collects and groups only that space not occupied by 
files. 



General Information 

While CALL "COMPRS" is quite useful, it cannot collect all the free space on the disc. It 
also may cause the system to run slower on files that have been expanded after being 
created. To collect and group 1 00% of the free space, a CALL "DUP" command must be 
executed. 
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An unmarked bad block may be encountered during a COMPRESS execution. This results 
in a device I/O error. There is no way to tell which file contains the bad block unless each 
file is read. When the bad block in the file is encountered, an error message containing 
the bad block address is displayed. This address must be entered in a CALL "MRKBBG" 
command. After this command has been executed, CALL "COMPRS" may be issued. 

If the bad block is contained in the directory, a CALL "DUP" command is necessary for 
information recovery. The duplicated disc information will be missing one or more library 
structures corresponding to the extent of damage or wear in the directory. If the available 
system contains only a single drive, the disc cannot be read and must be discarded. 



Prerequisite 

Device must be reserved. 

Examples 

Example 1 : 

1 1 CALL "C0MPRS",B2,A1 

The address of the device is in 82. First, the system checks the address; then it 
finds the device. If 1 has been previously entered in A1, this example collects and 
groups all space inside and outside files. 

Example 2: 

140 CALL "COMPRS",2,0 

This example, with actual values in the last two fields, locates the device with the 
address of 2 and then collects and groups all space not occupied by files (as 
specified by 0). 
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CALL "CUSTAT" (Controller Unit Status) 



Purpose 



The CALL "CUSTAT" command generates status messages for all devices (disc drives) 
interfaced to the 4907 File Manager controller. This command does the same thing CALL 
"DSTAT" does except it generates messages for all devices, rather than a specified 
device. 



SYNTAX FORM 

CAL "CUSTAT", string variable 

DESCRIPTIVE FORM 

CALL "CUSTAT", target string variable 



Field Definitions (Descriptive Form) 



CALL "CUSTAT" 



These are the keywords for the command. 
They may be entered as shown in SYNTAX 
FORM. 



target string variable 



This is where device status messages are 
sent. The target string variable must be 
dimensioned large enough to accommodate 
the messages. Each device status message 
is 1 86 characters. 
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CALL "CUSTAT" 



General Information 



If the controller Is designed to support more devices than are Interfaced, the CALL 
"CUSTAT" command returns "empty" device status messages. 



Prerequisites 

Set clock. 

Example 

CALL "CUSTAT", A$ 
This example generates device status messages on all devices and stores them In A$. 
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CALL "DISMOUNT" 

Purpose 

The CALL "DISMOUNT" command notifies the system that a disc is to be removed from 
active use. After DISMOUNT execution, no OPEN statements may be executed on the 
disc. The term "DISMOUNT" does not mean that the disc is physically removed from the 
drive. 



SYNTAX FORM 



CAL "DISMOUNT", numeric expression 



DESCRIPTIVE FORM 



CALL "DISMOUNT", device address 



Field Definitions (Descriptive Form) 

CALL "DISMOUNT" These are the keywords for this statement. The entry may be 

made as shown in SYNTAX FORM. 



device address 



The device address may be seen on or near the front of the 
device. 



General Information 

All files must be closed before a DISMOUNT command will take effect. If a file is open at 
the time of execution, the system waits until it is closed. File I/O, however, may continue. 
After a dismount, no files may be opened on that device until a CALL "MOUNT" command 
is executed. 
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CALL "DISMOUNT" 



Prerequisites 

Files must be closed. 

Examples 

Example 1 : 

115 CALL "DISM0UNT",C1 

This example tells the system that the device with its address in C1 is to be 
Dismounted. 

Example 2: 

155 CALL "DISM0UNT",2 

This example informs the system that the device with the address'2 is to be 
Dismounted. 
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CALL "OREL" (Device Release) 



Purpose 



When a device is reserved it must subsequently be released in order to open files. The 
CALL "DREL" command releases the addressed device previously reserved with a CALL 
"ORES" command. 



SYNTAX FORM 



CAL "DREL", numeric expression 



DESCRIPTIVE FORM 



CALL "DREL", device address 



Field Definitions (Descriptive Form) 



CALL "DREL" 



These are the keywords for this command. Entry may be made 
as shown in SYNTAX FORM. 



device address 



The device address is shown on or near the front of the device. 



General Information 



The addressed device must be reserved, or the statement will be ignored. 
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Prerequisites 

Device must be reserved. 

Examples 

Example 1 : 

110 CALL "DREL",B2 
This example releases the device that has its address stored in B2. 
Example 2: 

175 CALL "DREL",2 
This example releases the device with address 2. 
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CALL "ORES" (Device Reserve) 

Purpose 

The CALL "DRES" command provides exclusive device control. This command is 
necessary when formatting a file or when the CALL "COMPRS" or CALL "DUP" 
commands are executed. 



SYNTAX FORM 



CAL "DRES", numeric expression 



DESCRIPTIVE FORM 



CALL "DRES", device address 



Field Definitions (Descriptive Form) 



CALL "DRES" 



These are the keywords for this statement. Entry may be made 
as shown in SYNTAX FORM. 



device address 



The device address may be seen on or near the front of the 
device. 



General Information 

All files on the device must be closed before command execution. An error message 
appears if there are any open files. This command may be executed even if the disc is 
missing or the device is not up to speed or has an open device door. 
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Prerequisites 

All files must be closed and clock set. 

Examples 

Example 1 : 

105 CALL "DRES",A 
This example reserves the device with its address stored in A. 
Example 2: 

115 CALL "DRES",3 
This example reserves the device with address 3. 
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CALL "DSTAT" (Device Status) 
Purpose 

The CALL "DSTAT" command determines the status for the device being addressed. This 
includes the disc identification number, name of disc, etc. See DEVICE AND FILE STATUS 
MESSAGES (Appendix A). CALL "DSTAT" generates and stores the same status message 
produced by executing a CALL "MOUNT" command. CALL "DSTAT", unlike CALL 
"MOUNT", also generates "full" file status messages on any open files in addition to the 
device status message. 



SYNTAX FORM 



CAL "DSTAT", numeric expression, string variable 



DESCRIPTIVE FORM 



CALL "DSTAT", device address, target string variable 



Field Definitions (Descriptive Form) 



CALL "DSTAT" 



These are the keywords for this command. 
Entry may be made as shown in SYNTAX 
FORM. 



device address 



The device address may be seen on or near 
the front of the device. 



target string variable 



The file and device status messages are 
sent to this location. This string variable 
must first be dimensioned to hold more than 
72 characters; i.e., DIM A$ ( N). 



The device status message is 1 86 charac- 
ters. Each "full" file status message is 189 
characters plus the number of characters in 
the F.l.'s. 
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General Information 



See DEVICE AND FILE STATUS MESSAGES (Appendix A) for message details. 

Prerequisites 

Set clock. 

Example 

190DIM A$(3000) 

200 CALL "DSTAT",2,A$ 

210 PRINT A$ 

This example first dimensions A$ to 3000 bytes. It then requests the status of the 
device at address 2. The message(s) is stored in A$. Execution of line 21 then 
prints the messages to the 4051 screen. 
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CALL "FFRMT" (Fast Format) 

Purpose 

The CALL "FFRMT" command operates like CALL "FORMAT". The only difference is that 
this command does not perform a surface analysis. Instead, the bad block or sector 
information from the existing volume label is placed on the new volume label created mXh 
this CALL "FFRMT" command. As a result, the formatting is faster. 

Syntax, Descriptive Forms, and Field Definitions 

These are identical to those used in the CALL "FORMAT" command; however, the 
keywords CALL "FFRMT" replace CALL "FORMAT". 

General Information 

Attempting a CALL "FFRMT" on a volume not previously formatted or a volume with a 
damaged volume label results in an error message. 

Unless full formatting (CALL "FORMAT") is carried out, bad block or sector information 
carried over from the old disc with a CALL "FFRMT" command may prevent full use of the 
new disc. 

This command automatically executes CALL "MOUNT" after its execution, but no device 
status message is generated. 

Prerequisites 

Device must be reserved. 



4907 FILE MANAGER OPERATOR'S (5) 5-31 



COMMAND DESCRIPTIONS 
CALL "FORMAT" 



CALL "FORMAT" 



Purpose 

The CALL "FORMAT" command prepares a new disc for data storage. The command will: 

• Record a volume "label" on the disc.The volume label contains disc identification 
and specification data entered in this command. 

• Conduct a surface analysis to detect bad block or track locations and then place 
this information on the label. The information on the label may be reviewed by 
executing CALL "DSTAT" or CALL "MOUNT". 



SYNTAX FORM 

CAL "FORMAT", numeric expression, string, numeric expression, numeric expres- 
sion, string, string, numeric expression, numeric expression, numeric expression, 
numeric expression, numeric expression. 

DESCRIPTIVE FORM 

CALL "FORMAT", device address, volume identification, volume number, number of 
volumes, owner I.D., master password, 1st level chains, 2nd level chains, 3rd level 
chains, 4th level chains, 5th level chains. 



Field Definitions (Descriptive Form) 

CALL "FORMAT" 



These are the keywords for this command. 
The entry can be made as shown in SYNTAX 
FORM. 



device address 



The device address is shown on or near the 
front of the device. 



volume identification 



volume number 



This entry is the "name" of the disc. The 
entry may be 1 to 1 characters. The first 
character must be alphabetic; the rest may 
be alphanumeric. 

Enter 1. 



number of volumes 



Enter 1 
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owner identification 



This entry can indicate the name of the 
person formatting the disc, the department 
with files on the disc, the primary user, etc. 
The entry can be up to 24 characters, which 
may be any combination of letters and 
numbers. 



master password 



The master password may be used in CALL 
"MRKBBG" and KILL. This affects the files 
in those commands even if the specified 
passwords for those files are not used. 



The entry may be up to 1 characters. The 
first character must be alphabetic; the rest 
may be alphanumeric. 



1st level chains 
2nd level chains 
3rd level chains 
4th level chains 
5th level chains 



The disc controller may be requested to 
speed up its file location processes; how- 
ever, more space on the disc must be 
devoted to implementing this increase in 
speed. This means less room is available for 
file storage. The entries in these five fields 
may be used to vary this speed/space ratio 
when executing such search commands as 
DIRECTORY, RENAME, COPY ... TO, OPEN 
(GROUP) and CALL "FILE". 



The entries in each field may be 1 through 
1 0. The higher the number, the faster the 
search commands are executed. Approxi- 
mately 5K bytes of extra space are con- 
sumed if 1 0's instead of 1 's are entered. The 
following entries are suggested for the five 
fields: 

1 St level = 7 
2nd level = 7 
3rd level = 3 
4th level = 3 
5th level = 3 
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If more speed is required, the numbers may 
be increased. 

If more space is required the numbers may 
be decreased. 



General Information 

Whenever a volume (disc) is formatted all, existing data is erased. To be sure the user 
does indeed intend a CALL "FORMAT" command, the following message always appears 
after initiating CALL "FORMAT": 

FORMAT REQUESTED, OK TO DESTROY DATA ON DEVICE 0? 

The amount of free (available) space remaining after a CALL "FORMAT" command may 
be determined by executing CALL "DSTAT." 

This command automatically executes CALL "MOUNT" after its execution, but no device 
status message is generated. 

The only way volume label information may be changed is by executing a CALL "DUP" 
command and copying all information to another disc. 



Prerequisites 

Device must be reserved. 

Examples 

Example 1 : 

CALL"FORMAT",2,"MEDCOSTS",1,1,"HOSP","PASS",7,7,3,3,3 

This example accesses the disc in device 2 and specifies Its name as "MEDCOSTS", 
its identification number as 1 , the number of volumes involved as 1 , the owner as 
"HOSP", and "PASS" as the master password. The number of 1st, 2nd, 3rd, 4th and 
5th level chains are specified as 7,7,3,3 and 3, respectively. 
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Example 2: 

CALL"FORMAT",A,A$,B,C,B$,C$,D,E,F,G,H 

This example accesses the disc specified in A and specifies the identifying name 
located in A$. The identification volume number (which must be 1) is located in B, 
the number of volumes (which must be 1 ) is located in C, the owner's name is 
located in B$ and the master password located in C$. The number of 1 st, 2nd, 3rd, 
4th and 5th level chains are located in D, E, F, G and H, respectively. 
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CALL "HERRS" (Hard Error Status) 
Purpose 

The CALL "HERRS" command is a diagnostic tool only. This command allows a user to 
tell if the device (disc and drive) or the host is responsible for system malfunctions or 
slow downs. This command returns disc and drive hard and soft error information to the 
variables specified. Since CALL "HERRS" normally is used in diagnostic programs, it is 
not required in day-to-day system operation. 



SYNTAX FORM 

CAL "HERRS", numeric variable, numeric variable, numeric variable, numeric 
variable, numeric variable 



DESCRIPTIVE FORM 

CALL "HERRS", device address, no. of retries in last I/O, no. of accumulated retries, 
no. of successful I/O recoveries, no. of unsuccessful I/O operations 



Field Definitions (Descriptive Form) 



CALL "HERRS" 



These are keywords for this command. Enter 
as shown in SYNTAX FORM. 



device address 



The device address is shown on or around 
the front of the device. 



number of retries last I/O 



This counter indicates the number of retries 
attempted during the last I/O operation up to 
a maximum of 255. 



number of accumulated retries 



This counter indicates the total number of 
retries since the last power up to a maximum 
of 65,335. 



number of successful I/O recoveries 



This counter indicates the total number of 
I/O operations that have been successfully 
recovered after one or more retries up to a 
maximum count of 65,535. These are soft 
errors. 
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number of unsuccessful I/O operations 



This counter indicates the total number of 
I/O operations that have not been success- 
fully recovered up to a maximum count of 
65,535. These are hard errors. 



General Information 

Although "HERRS" stands for "HARD ERROR STATUS", this command documents both 
hard and soft error frequency. 

Whenever the system increments the hard error counter by one, an error message is 
displayed. 

It is not necessary to execute the CALL "HERRS" command to initiate any of the counters 
as they function independently. CALL "HERRS" is used only to access the information. 
The number of retries required before the hard error counter is updated may vary. See the 
4907 Service Manual. 



Prerequisites 

None. 

Examples 

See 4907 Service Manual. 
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CALL "MOUNT" 



Purpose 

The CALL "MOUNT" command tells the system that the disc is in place and may be used. 
This command also generates a device status message identical to that generated by the 
CALL "DSTAT" command. If CALL "MOUNT" is not executed, the system has no way of 
knowing if the disc is in place, that it is turned on, etc. The system must be informed with 
this command. 



SYNTAX FORM 



CAL "MOUNT", numeric expression, string variable 



DESCRIPTIVE FORM 



CALL "MOUNT", device address, target string variable 



Field Definitions (Descriptive Form) 

CALL "MOUNT" 



These are the keywords for this command. 
Entry may be made as shown in SYNTAX 
FORM. 



device address 



The device address is shown on or near the 
front of the device. 



target string variable 



This is the location to which the device 
status message is sent. This string variable 
must first be dimensioned large enough to 
accommodate the incoming messages. Each 
device status message is 1 86 characters. 



If a fast command execution is necessary, 
the message may be eliminated by entering 
two quotation marks ("") in this field. See 
DEVICE AND FILE STATUS MESSAGES (Ap- 
pendix A) for details on message content. 
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General Information 

An error message appears if the device is not powered up, is not up to speed, or a CALL 
"SETTIM" command has not been executed. 



Prerequisites 

Set clock. 

Examples 

Example 1 : 

100 CALL "MOUNT",2,A$ 

This example tells the system the disc in device 2 Is ready for use and sends the 
device status message to A$. 

Example 2: 

150 CALL "MOUNT",B,"" 

This example tells the system that the disc with its address in B is ready for use. 
There is no device status message because the last field contains a null string ("") 
rather than a string variable. 
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CALL "MRKBBG" (Mark Bad Block Group) 

Purpose 

The CALL "MRKBBG" command tells the system that there are defective areas on the 
disc that are not to be used. This command Is necessary only after Error Message 1 5 
appears specifying the address of defective tracks or sectors. CALL "MRKBBG" is 
executed with this address in the last field. The defective space will not be used for 
subsequent data storage. This command is not commonly used in a program. 



SYNTAX FORM 



CAL "MRKBBG", numeric expression, string, string, string 



DESCRIPirVE FORM 

CALL "MRKBBG", device address, volume I.D., master password, address of 
defective space. 



Field Definitions (Descriptive Form) 



CALL "MRKBBG" 



These are the keywords for this command. Enter as shown in 
SYNTAX FORM. 



device address 
volume I.D. 



The device address is shown on or near the front of the device. 

This entry must be the same as that specified during the CALL 
"FORMAT" or CALL "FFRMT" command. If the volume I.D. is 
unknown, a CALL "DSTAT" command displays this disc informa- 
tion. 



master password 



The entry here must be the same as the entry in the CALL 
"FORMAT" or CALL "FFRMT" command. If there was no 
password but simply a null string {"") entered in that field, that 
string must also be entered here. 
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address of defective The entry in this field must match the first eight digits displayed 
space in the last field of Error Message 1 5. This is the message that 

appears when device hard errors occur. These digits indicate 
the number and location of the blocks causing the errors. 

The last two digits in the last field of Error Message 1 5 indicate 
the specific cause of the error. These last two digits indicate 
whether the message is the result of mechanical or bad block 
problems. See General Information below. 



General Information 

To mark a bad block group follow this procedure: 

1 . Write down location of bad block as shown in error message. 

2. Copy bad file to another location. 

3. Close all files. 

4. Reserve the device. 

5. Delete bad file. 

6. Execute CALL "MRKBBG" with location of bad block group. 

If the CALL "MRKBBG" command is successfully executed but hard error messages 
continue, the problem is more likely one of hardware operation rather than defective areas 
on the disc. Even though Error Message 1 5 indicates the number and location of "bad 
blocks," the message may actually be reflecting a malfunctioning read/write head or 
similar problem. If execution of CALL "MRKBBG" does not end I/O problems, check the 
last two values in the error message (NN) against the list of specific problems in the 4907 
Service Manual. 

If volume I.D. or master password is entered incorrectly the device must be dismounted 
and remounted before re-executing the command. This is necessary because the free 
space will show a decrease, but, in fact, the bad blocks will not have been marked. 

If the volume I.D. or master password has been incorrectly entered in a CALL "MRKBBG" 
command, a subsequent CALL "CUSTAT" command will show that the free space has 
been decreased. The disc, however, will NOT be marked. 
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Prerequisites 

Device must be reserved. 

Example 

The system has accessed device 1 with the volume I.D. of "SPECS." The master 
password is "LAB." The system is executing an I/O operation when this message 
appears: 

ERROR 1 5 DEVICE I/O ERROR 01 0001 FA-NN 

After following the procedure in General Information, enter and execute the following: 

CAL"MRKBBG",1 ,"SPECS","LAB","01 0001 FA" 

The bad blocks are marked, and no further attempts are made by the system to PRINT or 
WRITE data to them. 
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These commands create, rename, enlarge, reduce, open and close files as well as carry 
out many other file activities. 

ASSIGN 6-43 

CLOSE 5-45 

COPY ... TO 6-47 

CREATE 5-54 

DIRECTORY 5-59 

CALL "DUP" (Duplicate) 5-62 

END 5-64 

CALL "FILE" 5-65 

KILL 5-67 

CALL "NEXT" 5-69 

ON EOF (On End-of-File) 5-71 

OPEN 5-73 

CALL "RENAME" 5-78 

CALL "REWIND" 5-81 

SECRET 5-83 

CALL "SPACE" 5-84 

TYP (TYPE) 5-86 
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ASSIGN 



Purpose 



The ASSIGN command lets you make changes to the file attributes that were originally 
assigned in the CREATE command. 



SYNTAX FORM 

ASS F.I. ; string 

DESCRIPTIVE FORM 

ASSIGN F.I. ; attributes 



Field Definitions (Descriptive Form) 



ASSIGN 



F.I. 



attributes 



This is the keyword for the command. The entry may be made as 
shown in syntax form. 

The entries in this field must match the F.I. currently assigned to 
this file. 

Except for the BINARY or ASCII designations, any current file 
attributes may be changed by entering one or more of the 
following characters in this field. 

R (private) 

U(public) 

S(scattered) 

C(contiguous) 

N(not compressible) 

M(compressible) 

S can be changed to C only if the data entered so far is 

contiguous 

Conflicting entries such as R and U will result in the last, or 

"right-most", character being accepted. See CREATE command 

description. 
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General Information 

Generally, this command is executed from the keyboard rather than as part of a program. 

This command is always executed on a file in the current device. See UNIT command 
description. 

Prerequisites 

Device must be mounted but not reserved. 

Examples 

Example 1 : 

ASSIGN"@FINANCE/CNTRYBNK.OBJ";"R" 

This command changes the "CNTRYBNK.OBJ" file in "FINANCE" to a private status. 

Example 2: 

ASSIGN"$MATH.OBJ";"RSN" 

This command changes the "MATH.OBJ" file in the SYSLIB to a private, scattered 
and non-compressible status. 

Example 3: 

ASSIGN"$MATH.OBJ";A$ 

This command carries out the same function as example 2 if A$ = "RSN." 
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CLOSE 



Purpose 



The CLOSE command is used to close all open files or to close a specific file. 



SYNTAX FORM 

CLO [constant] 

DESCRIPTIVE FORM 

CLOSE [Ifn] 



Field Definitions (Descriptive Form) 

CLOSE This is the keyword for this command. Only three characters, or CLO, are 
required. 



Ifn 



Logical file number: The entry in this field specifies the particular file to be 
closed. This number, always an integer from 1 to 9, must match the logical 
file number assigned in the OPEN statement. When no number is assigned, 
all files in the 4051 internal tape unit and the external disc devices are 
closed. 



General Information 

See FILE POINTER OPERATION (Appendix C), which shows where the logical pointer is 
located after a file is closed. This is significant when the file is reopened for another read, 
write or update operation. 

This command is always executed on files in the current device. See UNIT command 
description. If the file specified in the command is not open, the CLOSE command is 
ignored. 

OLD, END, INIT or DELALL commands close all open files. Pressing the BREAK key twice 
also closes all open files. 
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Prerequisites 

None. 

Examples 

Example 1 : 

11 00 CLOSE 7 

This example closes a file that has been assigned logical file number 7. 

Example 2: 

1005 CLOSE 

This example closes all files on both the internal tape drive and all external disc 
devices. 
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COPY ... TO 

Purpose 

The COPY . . . TO command will copy one or more files named in an F.I. from one device to 
another or to a different location on the same disc. All attributes, as well as passwords 
and extensions, are also duplicated. Changes to names of files, passwords and 
extensions may also be made using this command. 



SYNTAX FORM 

COP F.I. .numeric expression TO F.I. .numeric expression 

DESCRIPTIVE FORM 

COPY F.I. #1 .source device address TO F.I. #2 .target device address 



Field Definitions (Descriptive Form) 



COPY ... TO 



These are the keywords for this command. 
They may be entered as shown in SYNTAX 
FORM. 



F.l.#1 



source device address 



This entry must match the F.I. of the file to be 
copied. Do not enter the "#1." If more than 
one file is to be duplicated or if F.I. changes 
are desired, see MULTIPLE FILE TRANS- 
FERS or CHANGING NAMES in this com- 
mand description. 

This is the address of the device that 
contains the files. This address is shown on 
or near the front of the device. 



F.l.#2 



The entry here shows not only where the file 
is to be copied, but also name changes to be 
made. Remember, two files with the same F.I. 
cannot be duplicated on the same disc. Do 
not enter the" #2." 
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target device address This is the address of the device that is to 

receive the information. The address is 
shown on or near the front of the device. 



General Information 

Duplication will not occur if: 

• F.I. #2 already exists on the second device. 

• The specified library contains no files. 

• The device (or devices) is reserved or write-protected. 

• The disc is not mounted or is incorrectly mounted. 

• The second device contains bad blocks. 

• Specified passwords are not used. 

• More than 8 files are open. 

This command is also used to copy files from one area to another on the same disc. 
Libraries are created in the new location if none exist. 
No files are erased. 

Prerequisites 

Discs must be mounted but the device must not be reserved. Files must be closed. 

Examples 

Example 1 : 

1 1 COPY"$DOG/CAT library,2T0" @MYLIBRY/DOG/CAT library",! 

Assume SCRATCHLIB is the current library. 

This example accesses SYSLIB on device 2 and copies file "CAT" in library "DOG" 
to MYLIBRY in device 1. 

Example 2: 

1 25 COPYA$,ATOB$,B 
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This example functions exactly as Example 1 if the F.I. and device address have 
previously been entered into the string variables and variables shown. 

A$ = "$DOG/CAT" 

A = 2 

B$ = "@MYLIBRY/DOG/CAT" 

B = 1 



Example 3: 



450 C0PY"FRED/T0M",1 TO" @Y0URLIB/FRED/T0M",2 



This example presumes that a CALL "USERLIB" has been executed specifying the 
1st level library in F.I. #1. 

Library "FRED" and file "TOM" in device 1 are copied to YOURLIB in device 2. 

Example 4: 

150COPY"FRED/TOM",1TO"@YOURLIB#',2 

This example functions like Example 3. The only difference is in the construction of 
F.I. #2. A pound sign (#) has been used to indicate that everything being 
transmitted, including the F.I., should be duplicated as it is. No slash (/) is necessary 
between the 1st level library (YOURLIB) and the "#." Don't confuse the F.I. #2 which 
means "File Identifier number two" and the special character pound sign (^^). 

Multiple File Transfers. Using "#", "*" or the "?" (see SPECIAL CHARACTERS IN FILE 
IDENTIFIERS in Section 4) in the F.I. construction allows selection and duplication of 
specific groups of files. The following examples illustrate how these characters may be 
used. Those libraries and files with passwords are ignored unless the password is part of 
the F.I. 

Assume "MYLIBRY" is the current library. 
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The Pound Sign (#) 

Example 1 : 

120 COPY "#",1T0"#",2 

This example duplicates everything in "MYLIBRY" on device 1 to "MYLIBRY" on 
device 2. This statement would not be carried out if both device addresses were 
identical. 

Example 2: 

1 80 COPY"DOG #',1 TO" #',2 

This example duplicates everything in the 2nd level library "DOG" in "MYLIBRY" on 
device 1 to "MYLIBRY" on device 2. 

Example 3: 

460 COPY" @YOURLIB #",1 TO" #',0 

This example duplicates everything in YOURLIB on device 1 to "MYLIB" on device 0. 

Example 4: 

1 80 COPY" #.CArM TO" #",2 

This example duplicates all files with the extension "CAT" contained in "MYLIBRY" 
on device 1 to "MYLIBRY" on device 2. 

The Asterisk (*) 

Example 1 : 

180 C0PY"MATH/VALG",1T0"#',2 

This example selects any file named "ALG" in any library in a library named 
"MATH." These files are located in "MYLIBRY" on device 1 and are duplicated in 
"MYLIBRY" on device 2. 
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Example 2: 

1 70 COPY" VDOG/CAT/MOUSE'M TO" #',2 

This example selects all 2nd level libraries with subsequent libraries of "DOG" and 
"CAT" with files of "MOUSE." These are located in "MYLIBRY" on device 1 and are 
duplicated on MYLIBRY on device 2. 

Example 3: 

285 COPY"FASTV*/*",1TO"#',2 

This example selects all 2nd level libraries with the prefix "FAST" and subsequent 
3rd and 4th level libraries and files. If a library with this prefix only contains files to 
the 3rd level or files that continue to the 5th level, no files will be selected. 

These libraries and files will be selected: 

FAST/RED/WHITE.YELL 

FASTLINE/RED/GREEN 

FASTLOOSE/YELLOW/BLUE 

These libraries and files will not be selected: 

FAST/RED/WHITE/YELLOW 
FAST/RED/WHITE:PASS 
GO/JIM/GREEN 
GOSOON/LIGHT/GOOD 

Files selected are duplicated from "MYLIBRY" on device 1 to "MYLIBRY" on device 2. 



Question Mark (?) 

Example 1 : 

1 70 C0PY"G0?/T0M/FRED"T0"#"2 

This example selects all 2nd level libraries with a two or three character prefix 
beginning with "GO". These libraries will be selected only if they contain a 
subsequent library of "TOM" and a file of "FRED". 
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These libraries and files will be selected: 

GO/TOM/FRED 
GOT/TOM/FRED 
GOB/TOM/FRED 
GOG/TOM/FRED.OBJ 

These libraries and files will not be selected: 

GOT/TOM/FRED/BOB 
GOD/TOM/FRED: PASS 
GOTT/TOM/FRED 

Libraries and files selected are duplicated from "MYLIBRY" on the current device to 
"MYLIBRY" on device 2. 

Example 2: 

210COPY"???/V*",1TO"@YOURLIB#',2 

This example selects all libraries with up to three character names with libraries in 
the 3rd level and files in the 4th level. They are duplicated to "YOURLIB" on device 
2. 

These files will be selected: 

TAD/OD/RATES 

D33/ZIP/NONE.OBJ 

DO/CONS/PROJ 

These files will not be selected: 

TAD/ALG/MATH/COMP 
GILD/TOM/FRED 
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Changing Names. Name changing may be accomplished while duplicating single files, 
without the use of special characters. Examples 1 through 3 show how to change names 
when single files are duplicated. Name changing while duplicating multiple files, however, 
requires using "#', "*", or the "?" (described in SPECIAL CHARACTERS IN FILE 
IDENTIFIERS in Section 4). These allow the user to change the names of libraries, files, 
passwords and extensions when transferring multiple files. Example 4 illustrates how 
these characters may be used. Assume "MYLIBRY" is the 1 st level or current library. 

Example 1 : 

120 COPY"® YOURLIB/TOM'MTO"BOB",2 

This example selects the file "TOM" in "YOURLIB" on device 1 . The file is 
duplicated as "BOB" on device 2 in "MYLIBRY." Remember, if "TOM" is only a 
library, no duplication will take place. 

Example 2: 

130 COPY"@YOURLIB/KEN/FRED:BEN",1TO"JANE/LORI:PAM",2 

This example selects the file "FRED" with the password "BEN" in library "KEN" in 
"YOURLIB" on device 1 . The file is duplicated on device 2 in "MYLIBRY" as file 
"LORI" with the password "PAM" under the new library "JANE." 

Example 3: 

275 COPY" A/B/C",3TO"$M/N/0",2 

This example selects the file "C" in libraries "MYLIBRY", "A" and "B" on device 3. 
The libraries and file are duplicated on device 2 in SYSLIB as "M", "N", and "O." 

Example 4: 

270 C0PY"$A#",1T0"B#",2 

This example selects all files in library "A" in "SYSLIB" on device 1 . These files are 
duplicated to "MYLIBRY" on device 2. The name of library "A" is changed to "B." 
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CREATE 



Purpose 

The CREATE command creates file space on the disc, assigns the attributes and F.I., 
including passwords and extensions, if any. The last two fields in this command are used 
to specify whether the file is to be random or sequential. 



SYNTAX FORM 



CRE F.I. [,string] ; numeric expression, numeric expression 



DESCRIPTIVE FORM 



CREATE F.I. [,attributes] ; number of logical records, record length 



Field Definitions (Descriptive Form) 



CREATE 



This is the keyword for this statement. Only three 
letters, CRE, are required. 



F.I. 



The entries in this field must meet F.I. requirements. 
See HOW TO WRITE A FILE IDENTIFIER in Section 4. 



attributes 



If no entry is made here, the system defaults to the 
following conditions: 

B (BINARY): Only binary data may be entered. 

R (PRIVATE): Read operations may not be executed 
without using the password if a password has been 
specified. 

S (SCATTERED): Files will be located wherever there 
is space (on a single disc only). 

N (NOT COMPRESSIBLE): Files may not be com- 
pressed when file space exceeds current stored 
program or data. 
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Any or alt of the above conditions may be changed by 
entering one or more of the following attributes: 

A (ASCII): Only ASCII data may be entered. 

U (PUBLIC): Read operations may be executed without 
using a password in an OPEN "G" command. 

C (CONTIGUOUS): File can be stored only as a whole 
entity in a single location. 

M (COMPRESSIBLE): File may be compressed if in 
excess of current stored program or data. 

H (HOST BINARY): File can only be used to store 
binary programs. 



number of logical records 



This entry specifies the number of records to be 
located within a random file, or, if the record length is 
zero, the length in bytes of a sequential file. To see 
how large your file must be, see HOW LARGE SHOULD 
THE FILE OR FILE RECORDS BE? later in this 
description. 



record length 



If file is to be random: 



This entry specifies the length of the records in bytes. 
These records are generally specified just long 
enough to contain the items or strings to be stored. 
See HOW LARGE SHOULD THE FILE OR FILE REC- 
ORDS BE? at the end of this description. 

If file is to be sequential: 

Enter zero (0). The number entered In the previous 
field is then the length of the file. 
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General Information 



The system automatically extends a file during WRITE, PRINT or SAVE operations if 
information exceeds allocated space. If the file has been designated C (contiguous) and 
there is an immediately adjacent file, an error message appears. Files cannot be extended 
over adjacent files in this way. If an error message appears, an ASSIGN command may be 
executed to change the attribute "C" to "S." 

This command is executed on a file in the current device. See UNIT command 
descriptions. 

Extended file space is always in multiples of 256 bytes. 



Prerequisites 

Disc must be mounted but device not reserved. File must not already exist. 

Examples 

Example 1 : 

1 00 CREATE "$MATH:RED.OBJ","U"; 1 00,1 28 

This command specifies that the file with the F.I. shown ($MATH:RED.OBJ) is to be 
public (U) which means it may be read without use of the password "RED." It also 
specifies there are to be 1 00 records of 1 28 bytes each. The entry in the last field 
indicates this is a random file. If the last entry were zero (0), the file would be a 
sequential file of 1 00 bytes. 

Example 2: 

1 00 CREATE A$,"UA";1 00,1 28 

This statement specifies that the entire F.I. is stored in A$ and that the file is to be 
public (U) and ASCII (A). This means it may be input without use of the password (if 
any). It also specifies there are to be 1 00 records of 1 28 bytes each. 
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Example 3: 

1 1 CREATE B$,C$;A,0 

This statement specifies that the F.I. is stored in B$ and that the attributes will be 
found in C$. The number of logical records normally is specified by the variable A, 
but because zero was placed in the record length file, the value of A will designate 
file length instead of number of records. This means this will be a sequential file. 

Example 4: 

110 CREATE B$,C$;A,B 

This statement specifies that the F.I. is stored in B$ and that the attributes will be 
found in C$. The numbers and length of logical records in the file is specified by the 
values of A and B, respectively. 

Example 5: 

140 CREATE"@MYLIBRY/JACK";1 000,0 

This statement creates a sequential file named "JACK" in "MYLIBRY" with default 
attributes and 1 000 bytes in length. 

How Large Should a File or File Record Be? 

The number of bytes allocated to a particular file or file record depends on whether you 
will be writing or printing information to that file. 

The table below shows how many bytes are required in WRITE and PRINT. 

ASCII 

Numeric values and 

strings 1 byte per character + 1 byte for EOR* 

BINARY 

Numeric values 9 bytes for any value + 1 byte for EOR* 

Strings 4 bytes + 1 byte for each character -I- 1 byte for EOR* 

*EOR = End of Record Item 
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See 4051 Graphic System Reference Manual for additional information about multiple 
items in a PRINT statement and the PRINT . . . USING statement. 

Remember that the "dynamic allocation" feature extends file space as information is 
entered. Both sequential and random files are extended in blocks of 256 bytes. Individual 
records in random files, however, cannot be extended in size. For this reason, it is 
important that you know the size requirements of the data you will be entering in random 
files before you create those files. 
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DIRECTORY 



Purpose 



The DIRECTORY command generates file status messages which may be displayed on 
the 4051 screen or stored on the 4051 internal magnetic tape. If the 4051 is equipped 
with Option 1 0, status messages may be output to the printer. 



SYNTAX FORM 



DIR 



DESCRIPTIVE FORM 




DIRECTORY [[l/O address] [format code [,F.I.]]] 



Field Definitions (Descriptive Form) 



DIRECTORY 



This is the keyword for this command. Only the first three 
characters, DIR, are necessary. 



I/O address 



If no entry is placed In this field, the system displays the 
messages to the 4051 screen. If the optional @33: is entered, 
the messages are stored on the 4051 internal magnetic tape. In 
this event, a file must first be prepared to accept the information 
with the BASIC FIND and MARK commands. Each full file status 
message is 1 89 characters plus the characters in the F.I. 
N represents the address of the printer if the option 1 is used. 



format code 



If there is no entry in this field or the entry is zero (0), the 
command returns a status message containing only the F.I. 
(names) of the file or files specified in the last field of this 
command. The format code field cannot be left blank if an entry 
is made in the F.I. field. 
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Entering 1 returns F.l.'s as well as relevant times and dates 
involving the file or files specified in the last field of this 
command. 

Entering 2 returns messages describing the "full file status." 
This means that not only are the F.l.'s time and dates returned 
but also information regarding file space and attributes. 

No passwords are returned when executing DIRECTORY. Fur- 
ther information about file status messages may be seen In 
DEVICE AND FILE STATUS MESSAGES (Appendix A). 



F.I. 



The system looks in this field for the F.I. of the file or files to be 
selected for a status check. If no F.I. entry is found, the system 
assumes that a status check is desired for ALL files in the 
current library. 



Special characters may be used in this field if special or multiple 
file selection is desired. 



General information 

This command is executed on a file in the current device. See UNIT command description. 



Prerequisites 



Disc must be mounted. 



Examples 



Assume, for examples 1-3, that SCRATCHLIB is the current library. 



Example 1 : 



100 DIRECTORY0,"@MYLIBRY#" 



This example generates status messages for all eligible files in "MYLIBRY." Since 
there is no I/O address entry, all messages display to the 4051 screen. A zero entry 
in the format code specifies that the status messages will contain only the F.l.'s of 
the selected files. 
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Example 2: 

100 FIND 10 

110 MARK 1,1000 

120 FIND 10 

130 DIRECTORY @33:2,"$STAT/TESTDESIGN" 

140 CLOSE 

This example locates the file "TESTDESIGN" in the library "STAT" in SYSLIB. The 
file status is then checked and a "full status message" is printed to the 4051 
internal magnetic tape. The message is stored on file 1 on the tape which 
previously has been marked or dimensioned to 1000 bytes. 

Example 3: 

100 DIRECTORY 

Because there are no entries in the optional fields in this example, default conditions 
apply. The above command actually appears like this to the system: 

100 DIRECTORY @32:0," @SCRATCHLIB#' 

This example displays to the 4051 screen "name only" file status messages for all 
files contained in SCRATCHLIB. 

Example 4: 

Assume for this example that MYLIBRY is the current library. 

100 DIRECTORY 

Because there are no entries in the optional fields in this example, default conditions 
apply. The above command actually appears like this to the system: 

100 DIRECTORY @32:0,"@MYLIBRY#" 

This example displays to the 4051 screen "name only" file status messages for all 
files contained in MYLIBRY. 
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CALL "DUP" (Duplicate) 



Purpose 



The CALL "DUP" command copies all files and libraries from one device to another. This 
command is often used to group all unused spaces in a disc into a single contiguous 
space on a different disc. This command may be used to recover data from a defective 
disc. This command is not applicable to single device systems. 



SYNTAX FORM 



CAL "DUP", numeric expression, numeric expression, numeric expression 



DESCRIPTIVE FORM 



CALL "DUP", source device address, target device address, compress control 



Field Definitions (Descriptive Form) 



CALL "DUP" 



These are the keywords for this statement. Entry may be 
made as shown in SYNTAX FORM. 



source device address 



The device address is shown on or near the front of the 
device. This is the device that contains the files to be 
copied. 



target device address 



The device address is shown on or near the front of the 
device. This is the device which will receive the information. 



compress control 



When 1 is entered, all free space transmitted will be 
collected and grouped as one contiguous space on the 
target device. When is entered, all free space transmitted, 
except that contained within files, will be collected and 
grouped as one contiguous space on the target device. 
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General Information 

1 . The disc receiving the information must first be formatted. Any entry in the master 
password field in the volume label on the new disc is replaced by the master 
password being transmitted from the old disc. No other volume label information from 
the output disc is copied to the new disc. 

2. When the CALL "DUP" command is executed, ALL INFORMATION ON THE TARGET 
DEVICE IS ERASED. 

3. All programs transmitted are duplicated as whole entities. No files are duplicated in 
"scattered" form. 

4. This command is not completed if more than eight files are open. 

5. The CALL "DUP" command does not transfer information to the internal magnetic tape 
or any outside device. 



Prerequisites 

A CALL "DRES" command must be executed on both devices. 

Examples 

Example 1 : 

110 CALL "DUP",D1,D2,A1 

This example transmits all file information from the device with its address in D1 to 
the device with its address in D2. If A1 contains the value of 1 , then all space, 
whether or not formatted as file space, will be duplicated as a single contiguous 
entity on the target device. 

Example 2: 

215CALL"DUP",1,2,0 

The last three entries here are actual values rather than numeric variables. All file 
information is transmitted from device 1 to device 2. Since the last field is 0, only 
that space outside file boundaries is collected and grouped. 
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END 



END 



Purpose 

END, a 4051 BASIC command, stops all program execution, closes all files and returns 
control to the 4051 keyboard. 



SYNTAX FORM 

END 

DESCRIPTIVE FORM 

END 



General Information 

Executing the END command does not affect the current device or the current library. 

Prerequisites 
None. 



5-64 



4907 FILE MANAGER OPERATOR'S 



COMMAND DESCRIPTIONS 
CALL "FILE" 



CALL "FILE" 



Purpose 



The CALL "FILE" command generates a file status message for the specified file and 
stores it in a string variable. Status messages for groups of files may be generated also. 



SYNTAX FORM 








CAL "FILE", numeric expression, 


F.I. 


string variable 


DESCRIPTIVE FORM 








CALL "FILE", device address, 


F.I. 


, target string variable 



Field Definitions (Descriptive Form) 



CALL "FILE" 



These are the keywords for this command. Entry may be 
made as shown in SYNTAX FORM. 



device address 



This is the address of the device containing the disc. The 
address is shown on or near the front of the device. 



F.I. 



This is the F.I. for the file to be accessed. Status messages 
from multiple files may be generated with use of special 
characters in the F.I. See SPECIAL CHARACTERS IN FILE 
IDENTIFIERS in Section 4. Passwords specified in the 
CREATE command are not necessary when writing the F.I. 
for this command. 



target string variable 



This is the location to which the message or messages will 
be sent. This variable must first be dimensioned large 
enough to accommodate the incoming messages. Each full 
file status message is 1 89 characters long plus the 
characters in the F.l.'s. 
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General Information 



All messages generated are "full file status" messages and contain pertinent times and 
dates, file space details and the complete F.I. See DEVICE AND FILE STATUS MESSAGES 
(Appendix A) for details on the file status messages. 

A CALL "FILE" command may be executed even when the device has been reserved. The 
command may also be executed without a prior OPEN command. 

This command will not be completed if more than eight files are open. 



Prerequisites 

Disc must be mounted. 

Examples 

Assume SCRATCHLIB is the current library. 

Example 1 : 

100 CALL "FILE",2,"@MYLIBRY#",A$ 

This example accesses device 2 and generates status messages for all files in 
MYLIBRY. The messages are then stored in A$. 

Example 2: 

100 CALL "FILE" AA$,B$ 

This example accesses the device specified in A and generates status messages for 
the file or files specified in A$. The messages are then stored in B$. 
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KILL 



Purpose 



The KILL command deletes single files, groups of files or all files on a particular disc. 



SYNTAX FORM 

KIL F.I. [.string] 

DESCRIPTIVE FORM 

KILL F.I. [.master password] 



Field Definitions (Descriptive Form) 



KILL 



F.I. 



master password 



This is the keyword for the command. It may be entered as 
shown in SYNTAX FORM. 

The file or files represented by the F.I. entry will all be deleted. 
The files must be closed and assigned passwords specified. 

If a master password was specified when the disc was originally 
formatted, it may be entered here. If the master password is 
entered, all closed files represented by the F.I. will be deleted. 
This will occur even if passwords normally required in the F.I. are 
not used. 



General Information 

Libraries cannot be deleted unless the disc is reformatted. This is true even though all 
subsequent files may have been deleted. 

This command will not be completed if more than eight files are open. 



Prerequisites 

Disc must be mounted but device must not be reserved. Files must be closed. 
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KILL 



Examples 

Example 1 : 

140 KILL "#","FRED" 

This example deletes all closed files in the current library whether or not the files or 
preceding libraries contain passwords. See SPECIAL CHARACTERS IN FILE 
IDENTIFIERS in Section 4 for a full description of the use of "#" and other special 
characters. 

Example 2: 

21 KILL " @MYLIBRY/A/B/C" 

If file "C" is closed and contains no password, this example deletes it. 

Example 3: 

470 KILL "$A/B.*" 

This example kills all closed "B" files contained in SYSLIB and library "A" when 
those files contain any kind of extension (including blank extensions). 
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CALL "NEXT" 



Purpose 



The CALL "NEXT" command opens the next file in a series of files opened by an OPEN 
"G" (group) command. As each new file is opened, the CALL "NEXT" command generates 
a file status message which is sent to the target string variable. 



SYNTAX FORM 



GAL "NEXT", numeric expression, string variable 



DESCRIPTIVE FORM 



CALL "NEXT", Ifn, target string variable 



Field Definitions (Descriptive Form) 



CALL "NEXT" 



These are the keywords for the command. 
They may be entered as shown in SYNTAX 
FORM. 



Ifn 



Logical file number. This number must be 
the same as specified in the previous OPEN 
command. 



target string variable 



As each new file is opened, its file status 
message is sent to this string variable. No 
status messages will be generated if, a null 
string ("") is entered here, instead of a string 
variable. 



Any string variable used for file status 
messages must be dimensioned large 
enough to contain the information. Each full 
file status message is 189 characters plus 
the characters in the F.I. 
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General Information 



1 . If a CALL "NEXT" command is executed after a normal OPEN (not group) command, 
an error message is displayed. 

2. If an OPEN "G" command locates a single file but the first CALL "NEXT" finds no files, 
a null string is generated and stored in the target string variable. 

3. If OPEN "G" locates no files, the first CALL "NEXT" generates an error message. 

4. If a CALL "NEXT" has located no files the following CALL "NEXT" generates an error 
message. 

5. When CALL "NEXT" is executed, the current file is closed. 

6. CALL "NEXT" always executes on a file in the current device. See UNIT command 
description. 



Prerequisites 

File must have been opened with an OPEN "G" command. 

Examples 

Example 1 : 

800 CALU'NEXT",2,A$ 

This example opens the next file in a group of files that were specified in an earlier 
OPEN "G" command as Ifn 2. The file status message is sent to A$. 

Example 2: 

450 CALL"NEXT",A,B$ 

This example opens the next file in a group of files specified in an earlier OPEN "G" 
command. The Ifn stored in A must be the same as that in the OPEN "G" command. 
The file status message is sent to B$. 
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ON EOF (On End-Of-File) 



Purpose 



This form of the 4051 BASIC ON . . . THEN statement allows continued program operation 
when the end-of-file is encountered. It is particularly useful when retrieving information 
from a file of unknown length. 



SYNTAX FORM 



ON EOF (numeric expression) THE constant 



DESCRIPTIVE FORM 



ON EOF (Ifn) THEN line number 



Field Definitions (Descriptive Form) 



ON EOF THEN These are the keywords for the command. 



Ifn 



Logical file number: This is the same number that is assigned to a 
particular file in the OPEN command. 



line number 



This line number is executed after encountering the end of the file. 



General Information 

1 . If no ON EOF command has been entered in the program, an error message is 
generated when the end-of-file has been reached. 

2. If the 4051 is equipped with a C01 (Bisynchronous Interface), it will have the logical 
file number 9. This can cause a problem if a disc file has been assigned a logical file 
number 9. If both devices are in use in the same program, separate ON EOF 
commands must be provided for each. 

3. See the ON . . . THEN command description in the 4051 Graphic System Reference 
Manual for further details. 
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Prerequisites 

None. 

Example 

120ONEOF(2)THEN 140 

This example executes line 1 40 when the end of file has been reached on the file 
represented by Ifn 2. 
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OPEN 



Purpose 

The OPEN command must be executed before the majority of file management and I/O 
commands can be executed. See GENERAL SEQUENCE FLOW CHART in Section 2. This 
command allows the user to specify: 

1 . A logical file number representing the file. This number eliminates the need for 
rewriting the F.I. in many subsequent commands. 

2. Whether access is to be read and write, read only, or update. 

3. Whether single or multiple files are to be opened. 

4. The string variable in which the file status message is to be stored. 



SYNTAX FORM 








OPE F.I. [,"G"];constar 


t, string, string variable 




DESCRIPTIVE FORM 








OPEN F.I. ["GROUP"] ; 


Ifn, type of access. 


target string 


variable 



Field Definitions (Descriptive Form) 



OPEN 



This is the the keyword for the command. It may be entered as 
shown in SYNTAX FORM. 



F.I. 



This entry must match the current F.I. of the file to be opened. 
Special characters must be used when entering the F.I. in this 
field if multiple files are to be opened. See SPECIAL CHARAC- 
TERS IN FILE IDENTIFIERS in Section 4. 



GROUP 



This entry is required if multiple files are to be opened. Only the 
character "G" must be entered. File contents may be binary or 
ASCII in random or sequential files. 
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Ifn 



Logical file number: The number entered here must be an 
integer 1 to 9. This number is used to represent the F.I. in 
subsequent commands. This eliminates the need for writing out 
the F.I. each time. 



type of access 



This entry specifies the type of access intended for this file 
during this OPEN. 



Enter an "R" if you intend to only read from a file. 

Enter a "U" if updating (adding to) a SEQUENTIAL file. No data is 
destroyed if file is opened and rewound, partial data is entered, 
and the file is then closed. 

Enter an "F" if writing to a RANDOM or SEQUENTIAL file. F 
indicates "FULL" access for read or write (all I/O operations). 




If a SEQUENTIAL file is opened for full access (F), the pointer is moved to 
the beginning of the file. If no reading or writing is carried out and the file 
is closed, the pointer remains at that point. This means that all data past 
that point is lost. This does not apply if files are closed with I NIT or 
DELALL. 



target string variable 



When the OPEN command is executed, a file status message is 
generated. This message is then stored in the string variable 
specified here. The parameters are: 



• last date altered 

• last date used 

• date created 

• number of current OPENS 

• current bytes allocated 

• number of bytes used 

• record size 

• file attributes 



The last field in the message shows the entire F.I. for the file. 

Remember to dimension the string variable large enough to 
contain the file message, that is, DIM A$(300). The file status 
message is 1 89 characters plus the characters in the F.I. 
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See DEVICE AND FILE STATUS MESSAGES (Appendix A) for 
further details. 

If OPEN "G" has been executed, the file status message sent to 
the string shows the status of the first file to be opened. If there 
are no files, the string variable will contain a null string (""). 



General Information 

This command is executed on a file in the current device. See UNIT command description. 

If no UNIT command is previously executed, the system defaults to Device 0, which may 
or may not exist (depending on how the address straps on the disc drives have been set). 

If files are not created prior to an OPEN "G" command, an error message appears. 

Since it occasionally is necessary to conveniently review what has just been entered, the 
CALL REWIND command may be executed. This positions the file pointer back to the 
beginning of the file without CLOSE command and another OPEN command. See FILE 
POINTER OPERATION (Appendix C) for further details. 

Prerequisites 

Disc must be mounted but device must not be reserved. 

Examples 

Example 1 : 

10 OPEN "$FOOD/PRODUCT/SUPPLIERS";3,"R",A$ 

This example accesses "SYSLIB" and libraries "FOOD" and "PRODUCE." It then 
opens the file "SUPPLIERS." The logical file number is specified as 3, the type of 
access is "R" (read only), and A$ is specified as the destination for the file status 
message. 

The arrow indicates the file selected in the SYSLIB storage structure shown in Fig. 
5-1. 
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2380-34 



Example 2: 



Figure 5-1. Sample Storage Structure (4 Levels, 3 Files). 



115 0PEN A$;5,B$,C$ 



This example opens the file specified by the F.I. in A$. The Ifn is specified as 5, the 
character in B$ specifies the type of file access, and C$ is specified as the 
destination for the file status message. 

Example 3: 

350 OPEN "@MYLIBRY/H0SPITAL/STJ0HNS#.RES","G";3,F,B$ 

This example accesses "MYLIBRY," "HOSPITAL" and "STJOHNS," and all 
subsequent files {#) with the extension "RES". Since this is a "GROUP" OPEN, a 
"G" is specified in the next field. If anything other than a "G" is entered, an error 
message appears. 

The Ifn is specified as 3, the type of file access is "F" (for FULL) and B$ is the 
destination for the file status message. 

The arrows indicate the files selected in the "MYLIBRY" storage structure shown in 
Fig. 5-2. 
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GYN.INT 



GYN.RES 




PSY.INT 



PSY.RES 



Figure 5-2. Sample Storage Structure (4 Levels, 5 Files). 

Opening Multiple Files. The following sample shows how multiple files on different 
devices may be opened, assuming there are two devices, with addresses and 1 . 

100 UNIT 

nOOPEN A$;2,B$,C$ 

120 UNIT 1 

130 OPEN D$;3,E$,F$ 

1 40 (various I/O operations to Ifn 2 and 3) 
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CALL "RENAME" 

Purpose 

The CALL "RENAME" command is used to change the names of files, libraries, 
passwords, and extensions in F.l.'s. In some instances, changing names results in moving 
files to another library. This command is not generally used in a program. 



SYNTAX FORM 



CAL "RENAME", numeric expression, F.I., F. 



DESCRIPTIVE FORM 



CALL "RENAME", device address, old F.I., new F.I. 



Field Definitions (Descriptive Form) 

CALL "RENAME" These are the keywords for this command. Entry may be made as 
shown in SYNTAX FORM. 

device address The device address may be seen on or near the front of the device. 

old F.I. The F.I. of the file to be renamed is entered here. Special characters 

may be used. 



new F.I. 



The new F.I. is entered here. 



General Information 

The CALL "RENAME" command works only on those files with a creation date earlier than 
the present date of the system clock. For example: 

If you wish to rename a file that has an inaccurate creation date of February 1 0, 
1 987 and the correct time of the system clock is July 1 4, 1 978, CALL "RENAME" 
will fail. In fact, if the file creation date is only one second ahead of the system clock, 
the command will fail. 
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This command operates much like COPY ... TO when the command is used to change the 
names of libraries, files, passwords or instructions. There are two exceptions: 

1 . The CALL "RENAME" command will not copy files to another device. 

2. When a file is moved using CALL "RENAME", the file in the original location is erased 
and not retained as it is in COPY . . . TO. 

This command will not be completed if more than eight files are open. 



Prerequisites 



Disc must be mounted but device must not be reserved. 



Examples 

Example 1 : 

CALL"RENAME",2,"@YOURLIB/TOM/JANE","@YOURLIB/TOM/BILL" 

This example changes the name of the file in the library "TOM" in YOURLIB from 
"JANE" to "BILL." 




TO 




2380-36 



Figure 5-3. Sample Storage Structure Illustrating How to Change File Names. 
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Example 2: 



CALL"RENAME",2,"@Y0URLIB/T0M/JANE","$T0M/JANE" 

This example transfers the library "TOM" and the file "JANE" from YOURLIB to 
SYSLIB, as well as changing the F.I. 




YOURLIB 



TO 



TOM 



JANE 




2380-37 



Figure 5-4. Sample Storage Structure Illustrating How to Transfer Files From One Library to Another. 



Example 3: 



CALL"RENAME",A,A$,B$ 



This example accesses the device with its address in A and changes the F.I. in A$ to 
the F.I. in B$. 



Multiple File Name Changing. Special characters (#, *, ?) are required to change more 
than one F.I. with a single CALL "RENAME" command. See CHANGING NAMES in the 
COPY ... TO command description. 
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CALL "REWIND" 

Purpose 

The CALL "REWIND" command allows the pointer to be positioned back to the beginning 
of a sequential file (after the header). This allows data just entered to be read or new data 
to be reentered without the usual CLOSE and subsequent OPEN command. This 
command is unnecessary for random access files since commands with the record 
number one (1 ) will accomplish the same thing. 



SYNTAX FORM 



CAL "REWIND", numeric expression 



DESCRIPTIVE FORM 



CALL "REWIND", Ifn 



Field Definitions (Descriptive Form) 

CALL "REWIND" These are the keywords for the command. Entry may be made as 
shown in SYNTAX FORM. 



Ifn 



This entry must be the same as specified in the original OPEN 
command for this file. 



General information 

See FILE POINTER OPERATION (Appendix C) for further details. 

This command is always executed on a file in the current device. See UNIT command 
description. 



Prerequisites 



File must be open. 
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Example 

400 CALL "REWIND",2 
This example rewinds the pointer to the beginning of the file identified by Ifn 2. 
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SECRET 



Purpose 



The SECRET command prevents future listing of a binary program. It is executed just 
prior to saving the program to a file. 



SYNTAX FORM 

SEC 

DESCRIPTIVE FORM 

SECRET 



Field Definitions (Descriptive Form) 



SECRET 



This is the keyword for this command. Entry as shown in SYNTAX 
FORM. 



General Information 

If this command is written to an ASCII program, the program cannot be brought into 4051 
memory with an OLD command. ASCII programs with a SECRET designation, however, 
may be appended into memory. 

This command may be executed on a magnetic tape or disc file. 



Prerequisites 

None. 



4907 FILE MANAGER OPERATOR'S 



5-83 



COMMAND DESCRIPTIONS 
CALL "SPACE" 



CALL "SPACE" 

Purpose 

The CALL "SPACE" command is used to reduce or increase allocated file space. 
Normally, however, it is used to reduce the allocated space for a file only partially filled so 
that more space is available for other files. Although it may be used to increase a file size 
the system's dynamic space allocation feature makes this unnecessary. 



SYNTAX FORM 

CAL "SPACE", numeric expression, numeric expression, numeric variable, 
numeric variable 

DESCRIPTIVE FORM 

CALL "SPACE", Ifn, requested file size, target numeric variable, 
target numeric variable 



Field Definitions (Descriptive Form) 



CALL "SPACE" 



Ifn 



This is the keyword for this command. Entry 
may be made as shown in SYNTAX FORM. 

Logical file number: This entry must match 
the Ifn specified in the OPEN command. 



desired file size 



This entry, in bytes specifies how large the 
file is to be. The actual number of bytes will 
be in increments of 256. 



target numeric variable 



The amount of data, in bytes, already in the 
file is stored in the variable entered here. 



target numeric variable 



The actual file size, in bytes, after command 
execution is stored in the variable entered 
here. 
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General Information 

The space available for increasing a file may be seen by executing a CALL "DSTAT" 
command. This command returns the number of free bytes remaining on a disc. 

If the number of bytes specified in "desired file size" is less than the data required, the 
file will be reduced to just enough to hold the data. 

An easy way to release unused file space on the disc is to execute CALL "SPACE" with 
zero (0) bytes requested. 



Prerequisites 

File must be open. 

Example 

1 50 CALL "SPACE",3,1 OOOAB 

This example allocates 1 024 bytes to the file associated with Ifn 3. The number of 
bytes required by the data already in the file is sent to A. The actual number of bytes 
in the file after command execution is sent to B. 
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TYP (Type) 

Purpose 



TYP is a function rather than a command and performs in the same way for disc files as it 
does for the magnetic tape files. TYP determines whether the data is in ASCII or binary 
form, and if binary, whether data is numeric or alphanumeric. It also establishes if the file 
is empty, not open, or whether the end of the data has been reached (EOF character) or is 
illegal. 

This function is necessary whenever the type of data is unknown. It returns an integer 
from to 5, indicating one of the above conditions. See Table 5-1 or TYP in the 4051 
Reference Manual for details. 



SYNTAX FORM 

TYP (numeric expression) 

DESCRIPTIVE FORM 

TYPE (Ifn) 



Field Definitions (Descriptive Form) 

TYPE This is the keyword for the function. Enter as shown in the SYNTAX FORM. 

Ifn Logical file number: This is the same number specified in the OPEN 

command. 

See TYP in the 4051 Graphic System Reference Manual for further details. 
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Table 5-1 



DATA TYPE TABLE 






Empty File or File Not Open 


1 


End of File Character 


2 


Numeric Data or Character String Data/ASCII Format 


3 


Numeric Data/Binary Format 


4 


Character String Data/Binary Format 


5 


Illegal Data 



If the integer 5 is returned, data is illegal and cannot be read. 



Prerequisites 



File must be open. 
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FILE I/O COMMANDS 

These commands are used to place information into or to retrieve information from files. 

APPEND 6-89 

INPUT 6-92 

OLD 6-96 

PRINT 6-97 

READ 6-1 01 

SAVE 6-104 

WRITE 6-1 06 
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APPEND 

Purpose 

The APPEND command brings a program from a specified file on the disc and places it: 

a. Prior to the program already in memory or 

b. Within the body of the program already in memory or 

c. Subsequent to a program already in memory. 



SYNTAX FORM 

APP F.I. [, string] ; constant, constant 

DESCRIPTIVE FORM 

APPEND F.I. [."ASCII"] ; target line number, increment between line numbers 



Command Field Definitions (Descriptive Form) 



APPEND 



F.I. 



ASCII 



This is the keyword for this statement. Only three 
characters, APP, are required. 

This entry must match the F.I. already assigned this 
file or indicate the location of the F.I. with a string 
variable. 

"ASCII" or a string variable may be entered here. An 
"ASCII" entry implies that ASCII data is to be 
retrieved. If a string variable is used, it may 
represent "", implying binary data or "ASCII", imply- 
ing ASCII data. This way a A$ entry, for example, 
allows the same command to be used repeatedly to 
retrieve both kinds of data. 

If no entry is made, the system defaults to a binary 
append. 
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target line number This entry provides the line number of the current 

program to which the file program will be sent. The 
entry must be an integer of 1 to 65535. 

increment between line numbers This entry specifies the increment between line 

numbers. The entry must be an integer of 1 to 
65535. If no entry is made in this field, the 
increment defaults to 1 0. See the 4051 Graphic 
System Reference Manual for details. 



General Information 

The appended program is inserted into the current program at the target line number. The 
first statement transmitted from the file program REPLACES the statement already 
appearing on the target line number. Line numbers in the current program greater than 
the target line number will be placed after the program being brought in from a file. Only 
those line numbers following the target line number will be renumbered. 

This command is executed on a file in the current device. See UNIT command description. 



Prerequisites 

Disc must be mounted but device must not be reserved. File does not have to be OPEN. 

Examples 

Example 1 : 

1 00 APPEND "@MATH.0BJ";21 0,5 

This example appends a program with an F.I. of "MATH.OBJ" to the current program 
in memory starting with line number 210. The combined program is renumbered in 
increments of 5 from line 21 up. 

Example 2: 

1 20 APPEND "@ARCH:J1 500.OBJ'M 1 0,5 

This example appends a program with an F.I. of "ARCH.JI 500.0BJ." The target line 
number is 1 1 and the increment is 5. 
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Example 3: 

1 35 APPEND "$FUNNY.PGM";250 

This example appends the program in "FUNNY.PGM" located in SYSLIB. The target 
line number is 250. 

Example 4: 

1 40 APPEND B$;3500 

This example appends any program that has its F.I. located in B$. The target line 
number is 3500. 
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INPUT 



Purpose 

The INPUT command reads ASCII data that has been stored in the designated file with a 
PRINT command. It operates like the 4051 BASIC INPUT command with the following 
exceptions: 

1 . The Ifn (logical file number) specified in the preceding OPEN command must be 
entered. This I/O address tells the system which disc file to access. 

2. Random, as well as sequential files, may be INPUT. This means that, unlike magnetic 
tape files, it is possible to directly access a particular location in the file. 

3. The primary address character is "#'. 



SYNTAX FORM 

INP # constant [.numeric expression] : - 

DESCRIPTIVE FORM 



array variable 
string variable 
numeric variable] 



(array variable V 
string variable > 
numeric variablej_ 



iMoi IT ^ .* r ^ u 1 *^''9®* variables target variables 

INPUT # Ifn Uecord number] : f^^ incoming data ' for incoming data 



[ 



Field Definitions (Descriptive Form) 



INPUT 



This is the keyword for this command. It may be entered as 
shown in SYNTAX FORM. 



#lfn 



Logical file number: This number must match the Ifn specified in 
the OPEN command. 
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record number 



An entry is necessary in this field if you are inputting from a 
random file. An entry of 1 or greater places the logical file pointer 
at the first string in the record of that number. 



No entry is necessary in this field if you are inputting from a 
sequential file. However, if the statement is part of a program 
used to retrieve random file information one time and sequential 
file information the next, a numeric variable must be entered. See 
Example 4. 



target numeric 
variables for 
incoming data 



These entries specify where the string or parts of the string is to 
be sent. 



General Information 

1 . An INPUT command can only read ASCII information placed in the file with a PRINT 
command. 

2. For programming examples, see USING PRINT AND INPUT IN A PROGRAM (Appendix 
G). 



Prerequisites 



File must be open. 



Examples 



Example 1 : INPUTTING NUMERIC VALUES FROM A RANDOM FILE 

330 INPUT #3,10:A,B,C 

This example places the logical file pointer at the beginning of record 1 in the file 
associated with Ifn 3. The system then checks for the first numeric value in the first 
string. That value is stored in A. The system continues to search through record 1 0, 
string by string. If no further values are found, a search is begun through record 1 1 . 
If none are found, the next record is searched and so on. (Remember, everything 
entered in the PRINT command up to the first carriage return is considered a single 
string. Everything between the first carriage return and the second carriage return is 
also considered a single string and so on.) Eventually, if a second and third value are 
located, they are stored in B and C. 
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If less than three values exist in the entire file, an error message appears. 

Example 2: INPUTTING STRINGS FROM A RANDOM FILE 

430 INPUT #3,12:A$ 

This example places the logical file pointer at the beginning of record 1 2 in Ifn 3. The 
system then reads everything in that record up to the first CR and stores it in A$. 

Example 3: INPUTTING A STRING FROM A SEQUENTIAL FILE 

410 INPUT #3:A$ 

INPUT will start at the current pointer position in Ifn 3. The system then reads 
everything in the next string and stores it in A$. 

Example 4: INPUTTING A STRING FROM A RANDOM OR SEQUENTIAL FILE 

140 INPUT #4,A:A$ 

This retrieves a single string from the file and places it in A$. If A = and this is a 
sequential file, this command inputs the first string past the current pointer position. 

If A = 1 or greater and this is a random file, the string in the record (identified in A) is 
input. 
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OLD 



Purpose 



The OLD command loads a BASIC program in either binary or ASCII format from the disc 
file into the 4051 memory. 



SYNTAX FORM 

OLD F.I. [.string] 

DESCRIPTIVE FORM 

OLD F.I. [."ASCII"] 



Field Definitions (Descriptive Form) 



OLD 

F.I. 

ASCII 



This is the keyword for this command. 

This F.I. must match the F.I. used when the program was saved. 

If the program was saved in ASCII form, this entry must appear. If the 
program was saved in binary form, no entry is necessary. 



General Information 

1 . An error message appears if the program is not found or is a data file. 

2. If the program was originally stored in binary, it must be retrieved in binary. The same 
applies to programs stored in ASCII. 

3. Because this command executes an automatic DELETE ALL command as part of the 
operation, the current library is set to "SCRATCHLIB." The current device is set to 0. 

4. If an ASCII file has been designated SECRET, it cannot be brought into memory with 
OLD. A secret ASCII program may, however, be appended into memory. 
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Prerequisites 

Disc must be mounted but device must not be reserved. File does not have to be open. 

Example 

1 40 OLD "@MYLIBRY/STOCKS" 
This example transfers a binary program from the file "STOCKS" into 4051 memory. 
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PRINT 



Purpose 

The PRINT command stores ASCII data in the designated file. It operates like the 4051 
BASIC PRINT command with the following exceptions: 

1. The Ifn (logical file number) specified in the preceding OPEN command must be 
entered. This I/O address tells the system which disc file to access. 

2. Random, as well as sequential, files may be printed. This means that, unlike magnetic 
tape files, it is possible to directly access a particular location in the file. 

3. The primary address character is "#". 



/ string ) 
USIJ or : 
IconstantJ 

I;] 



(numeric expression) 
string J 



SYNTAX FORM 

PRI ^ constant [,numeric expression] 

(numeric expression^ 
string J 

DESCRIPTIVE FORM 

{format string \ 

or l:][item to be printed 

IMAGE line number) 
[ { . f item to be printed ]]...[;] 



Field Definitions (Descriptive Form) 



PRINT 



This is the keyword for this command. It may be entered as shown in 
SYNTAX FORM. 



# Ifn 



Logical file number: The number entered here must match the Ifn 
specified in the OPEN command. 
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record number 



An entry is necessary in this field if you are printing to a random file. 
The value of this entry must be 1 or greater. The logical file pointer is 
placed at the beginning of the record specified. 



No entry is necessary in this field if you are printing to a sequential 
file. However, if the statement is part of a program and is used to enter 
information in a sequential file one time and a random file another 
time, a numeric variable must be entered. 



USING 
data item 



See the 4051 Graphic System Reference Manual. 

This is the item to be stored. It may be the actual constant or string 
constant, a numeric expression, the location of the item in memory (A, 
A$, etc.), or a combination. 



data item 



Same as previous field. 



General Information 



NOTE 



If two strings are printed in a single statement without CRs (carriage 
returns) the system will not be able to distinguish between them and will 
input them both as a single string. 



1 . If you are updating a sequential file, that is, adding data to the end of existing 
information, "U" must be entered in the OPEN command. This places the logical file 
pointer at the end of the last item. PRINT then adds new data beginning at that point. 

2. Printing data to a record requires that all previous records be filled. See the file 
initializing program in SAMPLE PROGRAMS (Appendix F). 

3. If too much data is printed to a record in a random file the excess is placed in one or 
more following records. This destroys any existing data in those records. 

4. For examples of how to retrieve PRINTed information, see INPUT command 
description. 

5. For programming examples, see USING PRINT AND INPUT IN A PROGRAM 
(Appendix G). 
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Prerequisites 



Disc must be mounted but device must not be reserved. File must be open. 



Examples 



Example 1 : PRINTING TO A SEQUENTIAL FILE 

1 40 PRINT #3:"T0M"; "241 MAIN, MILL CITY";5464451 

The system considers TOM, 241 MAIN, MILL CITY 5464451 as a single string and 
stores it starting with the current pointer position. After PRINT is executed, the 
pointer is located just past the OR (carriage return) at the end of the string. 



TOM241 MAIN, MILL CITY5464451 



EOF 



f 



BEGINNING POINTER 
POSITION 



t 



ENDING POINTER 
POSITION 



Another string may be added by executing another PRINT command. The new 
information is recorded where the logical file pointer is located. The EOF mark is 
always moved along and placed just after the last CR. 

Example 2: PRINTING TO A SEQUENTIAL FILE 

135 PRINT #3: A$ 

This example functions exactly as Example 1 if: 

A$ = "TOM 241 MAIN, MILL CITY 5464451 " 
Example 3: PRINTING TO A RANDOM FILE 

340 PRINT #3,40."GRANT, TOM";"GEOL";2.5 

The system considers GRANT, TOM, GEOL and 2.5 as a single string and stores it 
that way at the very beginning of record 40 in Ifn 3. After PRINT is executed, the 
logical file pointer is located just past the CR at the end of the string. 
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Record #40 
boundary 



GRANT, TOMGEOL2.5 



EOF 



N bytes remaining in record 



BEGINNING POINTER 
POSITION 



f 



ENDING POINTER 
POSITION 



Even if there is enough space left in the record, no additional strings may be added 
by executing another PRINT command; each additional PRINT starts at the 
beginning of a record. 




Printing to a random file must be done witli great accuracy. If more data is 
transmitted than can be accommodated in the specified record, the data in 
the following record is overwritten. This does not apply to random binary 
files. 
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READ 



Purpose 

The READ command reads binary data stored in tlie designated file with a WRITE 
command. It operates like the 4051 BASIC READ command with the following exceptions: 

1 . The Ifn (logical file number) specified in the preceding OPEN command must be 
entered. This I/O address tells the system which disc file to access. 

2. Random, as well as sequential, files may be read. This means that, unlike magnetic 
tape files, it is possible to directly access a particular location in the file. 

3. The primary address character is "#'. 



SYNTAX FORM 



REA # constant [,numeric expression] 



DESCRIPTIVE FORM 



[array variable \ 
I string variable 
[numeric variable) 



{array variable ] 
string variable 
numeric variable) 



READ #lfn Lrecord number] : target variables 

for incoming data 



target variables 
' for incoming data 



Field Definitions (Descriptive Form) 



READ 



This is the keyword for this command. The entry may be made as 
shown in SYNTAX FORM. 



# Ifn 



Logical file number: The number must match the Ifn specified in 
the OPEN command. 



record number 



An entry is necessary in this field only if you are reading from a 
random file. An entry of 1 or greater places the logical file pointer 
at the first item in the record of that number. The READ starts 
from there. 
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No entry is necessary in this field if you are reading from a 
sequential file. However, if this is part of a program used to read 
random files one time, and sequential files the next, a numeric 
variable must be entered. See Example 4. 

target variables These entries specify where the Item (or items) being read is to 

for incoming data be sent. See the 4051 Graphic System Reference Manual for 

further details on array variables. 



General Information 

A READ command can only retrieve binary information placed in the file with a WRITE. 
For programming examples, see USING WRITE AND READ IN A PROGRAM (Appendix H). 

Prerequisites 

Disc must be mounted but device must not be reserved. File must be open. 

Examples 

Example 1 : READING NUMERIC ITEMS FROM A RANDOM FILE 

450 READ #3, 10:A,B,C 

This example places the logical file pointer at the first item in record 1 in Ifn 3, 
reads the first three items, which must all be numeric, and stores them in the 
variables shown. The record number in this statement shows that this is a random 
file. Unlike an INPUT command a READ command stops looking when it encounters 
an EOR (end-of-record). If the three items have not yet been found, an error message 
is generated. 

Example 2: READING NUMERIC ITEMS FROM A SEQUENTIAL FILE 

61 OREAD #3:A,B,C 

Because this is a sequential file (no record number entered), READ starts at the 
current pointer position. The first three items past this position must be numeric 
values. They are read and then stored in the variables shown. 
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Example 3: READING STRINGS AND NUMERIC ITEMS FROM A RANDOM FILE 

740READ#1,2:A$,B$,C 

This example reads the first three items In record 2 in Ifn 1 . These items, which must 
be a string, a string, and a variable, in that order, are then stored in the target 
variables shown. 

Example 4: READING STRINGS AND NUMERIC ITEMS FROM A RANDOM OR 
SEQUENTIAL FILE 

190 READ #5,B:A$,B$,C 

This reads the first three items. 

If B = and the file is sequential, the system reads the first three items past the 
logical pointer position and places them in the variables shown. 

If B = 1 or greater and the file is random, the system reads the first three items in 
the record of that number and places them in the variables shown. 

The first three items must be a string, a string, and a numeric value. 
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SAVE 



Purpose 

The SAVE command transfers a copy of the current BASIC 4051 program to a file on the 
disc either In binary or ASCII form. A SAVE command will create Its own file, if necessary. 



SYNTAX FORM 

SAV F.I. [.string] [; constant [.constant]] 

DESCRIPTIVE FORM 

SAVE F.I. [."ASCH"][; line number [beginning.ending line number ]] 



Field Definitions (Descriptive Form) 

SAVE This is the keyword for the command. It may be entered as 

shown In SYNTAX FORM. 

F.I. This F.I. must match the F.I. in the CREATE command. If no file 

has been created, this command will create Its own. 

ASCII If "ASCII" is entered in this field, the program is sent to storage 

In ASCII form. If no entry Is made, the program Is stored In host 
binary form. 

beginning line number If no ending line number is entered, a single line, specified by this 

entry, is saved. 

ending line number No entry can be made here unless a beginning line number is 

also entered. The program transfer ends after the statement with 
this line number. 
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General Information 

1 . The stored program may be retrieved with an APPEND or OLD command. 

2. If speed is important, programs should be saved in binary (default) form. 

3. A SAVE command may not be executed to a random file. 

4. A file does not need to be opened to execute a SAVE command. 

5. If the file exists prior to this command, the file type (ASCII or host binary) must match 
the type specified in the command. If the file does not exist, a new file of the correct 
type, with the Private attribute, and minimum length to store the program, is 
automatically created. 

Prerequisites 

Disc must be mounted but device must not be reserved. File does not have to be open. 

Examples 

Example 1 : 

400 SAVE "@MYLIBRY/ST0CKS";1 00,500 

The statements from 1 00 to 500 of the current program in memory are stored in a file 
with the F.I. shown. The program is stored in binary. 

Example 2: 

350 SAVE A$,"ASCII" 

This example places the entire program in memory into the file that has its F.I. stored 
in A$. The program is saved in ASCII form. 
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WRITE 



Purpose 

The WRITE command enters binary data into the designated file. It operates like the 4051 
BASIC WRITE command with the following exceptions: 

1 . The Ifn (logical file number) specified in the preceding OPEN command must be 
entered. This I/O address tells the system which disc file to access. 

2. Random, as well as sequential, files may be written. This means that, unlike magnetic 
tape files, it is possible to directly access a particular location in the file when writing 
or reading from a file. 

3. The primary address character is "#'. 

Unlike entries in the PRINT command, each string or numeric value in a WRITE command 
is considered a separate entry or "standard item." 



SYNTAX FORM 



WRI ?^ constant [.numeric expression] 



numeric expression 
string variable 



(numeric expression 
'Istrin 



ig variable 



DESCRIPTIVE FORM 

WRITE # Ifn [,record number] : data item [,data item] 



Field Definitions (Descriptive Form) 



WRITE 



This is the keyword for this command. The entry may be made as 
shown in SYNTAX FORM. 



# Ifn 



Logical file number: The number here must match the Ifn 
specified in the OPEN command. 
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record number 



An entry is necessary here if you are writing to a random file. 



The logical file pointer is placed at the beginning of the record 
specified. That is where WRITE will begin. When WRITE is 
executed, all subsequent items in THAT RECORD ONLY are 
erased. 



data item 



No entry is necessary if you are writing to a sequential file. If the 
WRITE is part of a program and is used to enter information in a 
sequential file one time and a random file another time, a 
variable must be entered. See example 4. 

This is the item to be stored. It may be the actual item (constant), 
a numeric expression, a variable (A, A$, etc.), or a combination. 



data item 



Same as previous field. 



General Information 

1 . If you are "updating" a sequential file, that is, adding data to the end of existing 
information, "U" must be entered in the previous OPEN command. This places the 
logical file pointer at the end of the last item. WRITE then adds data beginning at that 
point. 

2. For programming examples see USING WRITE AND READ IN A PROGRAM (Appendix 
H). 



Writing Data "in Between" In Sequential Files. As we have described, the logical file 
pointer in sequential files is always placed at the beginning of the file or at the end of the 
last item (with "U" in the OPEN command). There are times, however, when it may be 
necessary to WRITE data at a point between the first and last items. This means 
alternating TYP functions'" and READ commands must be executed. This will move the 
pointer item by item until it is at the desired location. WRITE may then be executed. 
Remember that all existing items past that point to the end of the file will be erased. 

This procedure is not possible with random files because each WRITE command returns 
the logical file pointer to the beginning of the record. See READ command description for 
examples of how to retrieve information written to a file. 



^ TYP functions are necessary only if the type of data item (a string or number) is unltnown. 
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Prerequisites 

Disc must be mounted but device must not be reserved. File must be open. 



Examples 



Example 1 : WRITING STRINGS AND A NUMERIC VALUE TO A SEQUENTIAL 
FILE 

150 WRITE #3:"TOM","241 MAIN, MILL CITY",5464451 

This example stores "TOM", "241 MAIN, MILL CITY" and 5464451 as three separate 
items: a string, a string, and a numeric value. 

Remember, any number within quotes is not considered a numeric value but part of a 
string. The WRITE command starts the at current pointer position. After the WRITE 
command is executed, the pointer is located at the end of the third item, as shown 
below. 



♦ 



string 




string 




numeric 








item 


TOM 


item 


241 MAIN, MILL CITY 


item 


5464451 


EOF 




header 




header 




header 









♦ 



BEGINNING POINTER POSITION 



ENDING 

POINTER 

POSITION 



Another WRITE command may be executed to add more strings. The new information 
is recorded starting where the logical pointer is located. If the file is closed first and 
then reopened, the next WRITE command places the new data at the beginning of 
the file. The OPEN command must contain "U", which will start WRITE at the end of 
the existing data. 

Example 2: WRITING STRINGS AND A NUMERIC VALUE TO A SEQUENTIAL 
FILE 

160 WRITE #3: A$, B$, C 

This example functions exactly as Example 2 if: 

A$ = "TOM" 

B$ = "241 MAIN, MILL CITY" 
C = 5464451 
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Example 3: WRITING STRINGS AND A NUMERIC VALUE TO A RANDOM FILE 

340 WRITE #3, 40: "GRANT, TOM", "GEOL", 2.5 

This example stores "GRANT", "TOM", "GEOL", and 2.5 as three separate items: a 
string, a string, and a number. The items are placed at the very beginning of record 
40 in Ifn 3. 



record 

#40 

boundary 


string 

item 

header 


GRANT, TOM 


string 

item 

header 


GEOL 


numeric 

item 
header 


2.5 


EOF 


N bytes 

remaining in 

record 



t 



I 



BEGINNING POINTER POSITION 



ENDING 

POINTER 

POSITION 



The logical pointer is now located at the end of the third item. 



NOTE 



If the record is too short for the binary information to be entered, an error 
message appears. 



If another WRITE command is executed to this record, the logical file pointer will 
move back, and the new information will be placed at the beginning of record 40. 

If information exceeds the remaining record space, an error message will appear. If it 
is less, the gap between the last item and the next record boundary will be 
automatically "padded." 

Example 4: WRITING TO A RANDOM OR SEQUENTIAL FILE 

260 WRITE #3,A:"TOM",61,2.45 

This example writes the items "TOM", 61, 2.45 to Ifn 3. If the value of A is zero (0), 
the system assumes the file is sequential. If the value of A is 1 or greater, it assumes 
the file is random and starts writing at the record with that number. 

Example 5: WRITING A SINGLE STRING TO A RANDOM FILE 

11 WRITE #3,20:"SMITH, 2.51 " 

This example writes a single string item to the beginning of record 20 in Ifn 3. 
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Section 6 
SPECIFICATIONS 

4907 PERFORMANCE SPECIFICATIONS 

1 . Data File Storage Capacity (formatted and accessible by operator) 

Per Drive (includes 

256-byte directory) 630,528 bytes 

Per Track 81 92 bytes 

Per Sector 256 bytes 

2. GPIB Data Transfer Rate 

Burst 3900 bytes/sec 

Sustained 1 300 bytes/sec 

3. Error Rate 

Refer to FLEXIBLE DISC DRIVE SPECIFICATIONS. 

4907 PHYSICAL SPECIFICATIONS 

1. Dimensions 

Height 7.94 in (20.17 cm) 

Width 20.31 in (51.59 cm) 

Depth (minus drive door handle projection) 25.25 in (64.1 4 cm) 

2. Weight 

Main Unit 51 lbs (23.1 kg) 

Auxiliary Unit of Option 30 50 lbs (22.6 kg) 

Auxiliary Unit of Option 31 62 lbs (28.1 kg) 
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4907 ENVIRONMENTAL SPECIFICATIONS 



1. Operating Environment 



Ambient Temperature 



Relative Humidity 
Maximum Wet Bulb 

Maximum Altitude Above Sea Level 



50 degrees F to 
1 00 degrees F 
(1 degrees C to 
38 degrees C) 
20% to 80% 
78 degrees F 
(25 degrees C) 
10,000 ft (3048 m) 



2. Storage Environment 



Ambient Temperature 



Relative Humidity 

Maximum Altitude Above Sea Level 

Shipping Temperature 



50 degrees F to 
1 25 degrees F 
(10 degrees C to 
52 degrees C) 
8% to 80% 

50,000 ft (15,240 m) 
40 degrees F to 
1 25 degrees F 
(-40 degrees C to 
52 degrees C) 



3. Shock (nonoperating) 

Unit will not suffer damage or fail to operate when subjected to three impact shocks of 
approximately 20 g's + in each direction along each main axis. Shock time is 1 1 ±1 
ms. 

4. Vibration 

Unit will not suffer damage or fail to operate when subjected to the following vibration 
for a period of 5 minutes along each main axis. 

Nonoperating 5 to 25 Hz at 0.008 in displacement 

25 to 55 Hz at 0.004 in displacement 
Operating 5 to 25 Hz at 0.001 4 in displacement 

25 to 55 Hz at 0.0007 in displacement 
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4907 Electrical Specifications 

1. AC Power Supply Requirements 

A rear panel line voltage selector matches the transformer inputs to four different line 
voltages. 50 Hz systems can be used by changing the pulley and belt in the disc drives. 
Table 2-1 shows the allowable line voltages: 





Table 6-1 






LINE VOLTAGES 




Line 








Voltage 


Tolerance 


Frequency 


Fuse 


1 00 Vac 


90-110 




2 A Med Blow 


1 20 Vac 


108-132 


50 or 60 Hz 


2 A Med Blow 


220 Vac 


198-142 


±.5 Hz 


1 A Med Blow 


240 Vac 


216-264 




1 A Med Blow 



2. Maximum power dissipation at 1 20 Vac, 60Hz, is 1 40 W. 

3. Maximum load current at 1 20 Vac, 60 Hz, is 1 .7 A. 

FLEXIBLE DISC DRIVE SPECIFICATIONS 

1 . Type 

Rackmount Flexible Disc Drive, with hard sector (32), write-protect hole detect, and 
double-density recording. 

2. Performance Specifications 



Capacity (unformatted) 

Per Disk 

Per Track 
Transfer Rate 
Latency (average) 
Access Time 

Track to Track 

Average 

Settling Time 
Head Load Time 



6.4 megabits 
83.4 kilobits 
500 kilobits/sec 
83 ms 

8 ms 
260 ms 
8 ms 
35 ms 
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3. Physical Specifications 



Error Rates 

Soft Read Errors 
Hard Read Errors 
Seek Errors 



1 per 1 0E9 bits read 
1 per 10E12 bits read 
1 per 1 0E6 seek 
operations 



4. Environmental Specifications 



Same as 4907 ENVIRONMENTAL SPECIFICATIONS. 



MEDIA REQUIREMENTS 



1 . Type 



Double-density 
compatible 



2. Storage Environment 



Temperature 



Humidity 



40 degrees F to 
1 40 degrees F 
(5 degrees C to 
60 degrees C) 

8% to 80% 



3. Media Lifetime 



Passes per track 
Insertions 



3.5 X 10E5 
> 30,000 
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ROM PACK 

1. Dimensions 

Length 466 in 

Width 2.62 in 

Depth 0.88 in 

2. Weight 8 oz 

3. Environmental Requirements 

Same as 4907 ENVIRONMENTAL SPECIFICATIONS. 

4. Power Requirements (from 4051) 
+ 5Vdc300mA 
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DEVICE AND FILE STATUS MESSAGES 

FILE STATUS MESSAGES 

File status messages are generated by CALL "FILE", DIRECTORY, and CALL "DSTAT" 
commands. The messages are stored in a string variable specified in the command. The 
messages generated by DIRECTORY may be displayed on the screen, printed, or stored 
on tape. 

A complete or "full" file status message has the following format: 



BRS NATR NNNNNNN ALLOC DD-MOM-YY HH:MM ALT 

NNNNNNN USED DD-MOM-YY HH:MM USED 

NOPEN NNNNNN REC LEN DD-MOM-YY HH.MM CREATED 

FILE IDENTIFIER 



Field Descriptions 

DD-MOM-YY HH.MM ALT 
DD-MOM-YY HH:MM USED 
DD-MOM-YY HH:MM CRE 

These fields show the day of the month, year, hour and minute the file was LAST 
ALTERED, LAST USED, and CREATED. If the system clock was not set, the fields look like 
this: 

"00-XXX-OO 00:00" 
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The following table shows which fields are updated when the commands listed are 
executed. 



Fields 


Last Altered 


Last Used 


Created 




CREATE 


CREATE 


CREATE 




COPY TO 


COPY TO 


SAVE (old 




(new file only) 


(both files) 


file only) 




CALL"DUP" 


CALL "DUP" (both 






(new file only) 


files) 






SAVE (both files) 


SAVE (both files) 






WRITE (updated 


CLOSE 




Commands 


when file is 
closed) 


ASSIGN 






PRINT (updated 


APPEND 






when file is 








closed) 








CALL "SPACE" 


CALL "RENAME" 






CLOSE (only if 








opened "F" se- 








quential) 







BRS N ATR 



Shows what the file attributes are, either as speci- 
fied in the CREATE command, or altered by the 
ASSIGN command. If a C follows the S in the 
attribute field, it means that although the file was 
specified "scattered," the file was created contigu- 
ously because plenty of room was available. 



NNNNNNN ALLOC 



Shows the number of bytes allocated to the file. 



NNNNNNN USED 



Shows the number of bytes actually used for 
storage. 



N OPEN 



Shows the number of current OPENs on this 
particular file. With single host systems this wil 
always be 1 . 



NNNNN REC LEN 



Shows the number of bytes allocated to each record 
in a random access file. Shows zero (0) for a 
sequential file. 
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FILE IDENTIFIER 



Shows the name of the file. This field will appear in 
the first line of the message if a DIRECTORY was 
executed. 



Example 



MYLIBRY/TOM/PERSONAL 
BUS N ATR 
1 OPEN 



9984 ALLOC 
6000 USED 
60 REC LEN 



01-DEC-77 12:30 ALT 
01-DEC-77 08:10 USED 
01-DEC-77 08:10 CREATED 



This message would appear after executing a DIRECTORY command for a file created at 
8:1 AM, last altered at 1 2:30 PM, with all activity taking place Dec. 1 , 1 977. Currently 
there is only one OPEN. The file was allocated 9,984 bytes of space, of which 6000 
contain information. The records in the file are 60 bytes long. "BUS N ATR" indicates the 
file contains binary, public and scattered but compressible, information. The F.I. indicates 
the name of the file is "PERSONAL" and is contained under libraries "TOM" and 
"MYLIBRY." 



General Information 

The DIRECTORY command allows the user to generate file status messages with three 
levels of information: 

The first level includes the F.I. only. 

The second level includes the F.I. and when the file was created, last used and last 
altered. 

The third level includes the F.I., attributes, space specifications, and when the file 
was created, last used and last altered. 



4907 FILE MANAGER OPERATOR'S 



A-3 



APPENDIX A 



DEVICE STATUS MESSAGES 

The device status messages are generated by the CALL "DSTAT", CALL "CUSTAT", and 
CALL "MOUNT" commands and are stored in the specified string variable. The message 
format is shown below: 

NN UNIT 

XXXXXXXXXXXX DEV ID XXXXXXXXXX VOL ID XXXXXXXXXXXXXXXXXXXXXXXX OWNER 
NNNNNNNNN FREE NNNNNNNNN SIZE NNNNNNNNN LOST NNNNN BLK SIZE DD-MMM-YY HH:MM 
FORMATTED NNNNN FILES OPEN RESERVED WRITE PROTECTED 



Field Descriptions 



NNUNIT 



Shows the device address. This field ap- 
pears only when CALL "CUSTAT" is exe- 
cuted. 



XXXXXXXXXXXX DEV ID 



Shows the nomenclature of the device. 



XXXXXXXXXX VOL ID 



Indicates the name of the disc as specified 
in the CALL "FORMAT" command. 



XXXXXXXXXXXXXX OWNER 



Indicates the owner's or user's name as 
specified in the CALL "FORMAT" command. 



NNNNNNNNN FREE 



Indicates the number of usable non-file 
space remaining on disc. 



NNNNNNNNN SIZE 



Shows the number of storage bytes provided 
by this type of disc. 



NNNNNNNNN LOST 



Indicates the number of bytes of unusable or 
damaged space. 



NNNNN BLK SIZE 



Indicates the size of each principal block. 



DD-MMM-YY HH:MM FORMATTED 



Indicates the day of the month, month, year, 
hour and minute the disc was formatted. 



NNNNN FILES OPEN 



Shows the number of files currently open. 
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RESERVED Appears only if device is reserved. 

WRITE PROTECTED Appears if device or disc is write-protected. 

Example 

01 UNIT 

4907 DEV ID INCTAX VOL ID 

SMITH & CO. OWNER 250000 FREE 630000 SIZE 

2560 LOST 256 BLK SIZE 07-MAR-77 1 0:30 FORMATTED 
00003 OPEN 

This message would be generated for device 1, which is identified as a 4907. The disc is 
identified as "INCTAX" and the owner as "SMITH & CO." There are 250,000 bytes of 
usable non-file space. The 630,000-size field indicates this is a flexible disc with 2,650 
bytes of unusable or damaged space. The block size is 256 bytes. 

The disc was last formatted on March 7, 1 977 at 1 0:30 AM. Three files on the disc are 
open, and the device is not reserved or write-protected. . 
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ERROR MESSAGES AND 
RECOVERY PROCEDURES 



(* Asterisks indicate that additional information will be displayed, further defining the 
error.) 



Error Message 


Cause 


Correction 


ERROR 1 


GPIB data transfer 


Execute an INITthen 


BUS I/O ERROR* 


error often caused 


reissue command. If this 




by statis electricity. 


is not successful, re- 
starting program may be 
necessary. 


ERROR 2 


4907 or 4051 error 


This message may also 


ILLEGAL COMMAND 




appear during a WRITE 
command if a device I/O 
error has occurred. If so, 
be sure the 4907 has 
been loaded and is oper- 
ating correctly. If error 
message repeats, see 
4907 Service Manual. 


ERROR 3 


4907 or 4051 error. 


See 4907 Service 


COMMAND FORMAT 




Manual. 


ERROR 4 


One or more entries 


Execute command again 


ILLEGAL COMMAND FIELDS 


in the CALL "FOR- 
MAT" or CALL 
"FFRMT" com- 
mands are illegal: 
volume number en- 
try is not 1, number 
of volumes entry is 
not 1, number of di- 
rectory chains is 
or greater than 1 0. 


with correct entries. 
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Error Message 


Cause 


Correction 


ERROR 5 


An attempt has 


Master password field 


ILLEGAL MASTER PASSWORD 


been made to exe- 


can contain no more 




cute a command 


than 1 characters. The 




containing an ille- 


first character must be 




gal entry in the 


alpha and the rest al- 




master password 


phanumeric. No spaces 




field. 


may be entered between 
characters. 


ERROR 7 


An F.I. has incorrect 


See FILE IDENTIFIER 


ILLEGAL FILE IDENTIFIER 


construction or ille- 


CONSTRUCTION in 




gal characters. 


Section 4. 


ERROR 8 


The volume I.D. 


The volume I.D. field can 


ILLEGAL VOLUME IDENTIFIER 


field in a formatting 


contain no more than 10 




command has ille- 


characters. The first 




gal characters, in- 


character must be alpha. 




correctly located 


No spaces may be en- 




spaces, or is blank. 


tered between charac- 
ters. The field cannot be 
blank. 


ERROR 10 


The system cannot 


Re-execute command 


DEVICE NOT FOUND 


find the device with 


with correct address. If 




the address speci- 


this message appears 




fied in the com- 


the first time the system 




mand. 


is used, the adjustable 
strapping in the con- 
troller may have been 
positioned incorrectly. 
See 4907 Installation 
Guide. 


ERROR 1 1 


An attempt was 


Be sure the device 


DEVICE WRITE PROTECTED 


made to write to a 


should be written to, and 




disc that is write- 


then turn off the write 




protected. 


protect switch for the 
device. Be sure the 
write-protect tape is 
covering the write-pro- 
tect hole on the disc. 
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Error Message 


Cause 


Correction 


ERROR 12 


The device was re- 


Release the device with 


DEVICE RESERVED 


served and a com- 


a CALL "DREL" com- 




mand requiring a 


mand and continue. 




free device was at- 






tempted. 




ERROR 13 


The device was not 


Execute a CALL "DRES" 


DEVICE NOT RESERVED 


reserved and a 
command requiring 
a reserved device 
was attempted. 


command and continue. 


ERROR 14 


A CALL "DRES" 


Close all files on that 


DEVICE HAS FILES OPEN 


command was is- 
sued to a device 
with open files. 


device and continue. 


ERROR 15 


A hard error has 


See CALL "HERRS" 


DEVICE I/O ERROR 


occurred on a dev- 


command description in 




ice. 


Section 5. If a particular 
location on a disc is 
causing repeated errors, 
it may be taken out of 
use with a CALL 
"MRKBBG" command. 
See 4907 Service 
Manual for complete de- 
tails. 


ERROR 16 ^ 


This message ap- 


Make sure address is 


DEVICE NOT READY* 


pears if: 


correct, that the disc is 




1 . The disc is not 


properly loaded, and that 




in place. 


the device is up to 




2. The disc has been 


speed. 




loaded improperly. 






3. The door has not 






been closed. 






4. The device is not 






up to speed. 




ERROR 17 


An attempt was 


Execute a CALL 


DEVICE NOT MOUNTED* 


made to use an un- 


"MOUNT" command and 




mounted disc. 


continue 
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Error Message 


Cause 


Correction 


ERROR 18 


There is not enough 


Delete any unneeded 


NO SPACE* 


space left on the 


files (KILL), gather the 




disc for further 


remaining free space in 




storage. 


a single area and with 
the CALL "COMPRS" 
command ll/O command 
may then be reissued. 


ERROR 20 


A command requir- 


Close two files and reis- 


CONTROL UNIT ERROR TABLE 


ing space equiva- 


sue the command. 


SPACE EXHAUSTED 


lent to two files was 
attempted with ei- 
ther 8 or 9 files 
already open. This 
eliminates room 
necessary for exe- 
cution of the com- 
mand. 




ERROR 22 


A hardware failure 


See 4907 Service 


CONTROL UNIT PROCESSOR ER- 


in the controller 


Manual. 


ROR RAM FAILED 


prevents further 
system use. 




ERROR 23 


The system is not 


Execute a CALL "SET- 


CLOCK NOT READY 


operating. 


TIM" command 


ERROR 32 


This may occur 


Execute CALL "DUP". 


DIRECTORY CHAIN DAMAGE* 


when attempting a 


Then reattempt CALL 




CALL "MOUNT" 


"MOUNT" on new disc. 




command. 


Information may be 
unrecoverable on a disc 
generating this massage. 
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Error Message 


Cause 


Correction 


ERROR 34 

DATA AREA DAMAGE* 


This results from 
damaged or bad 
blocks on a disc. 


Copy the file to another 
disc or to another area 
on the same disc. Then: 

1. Kill old file. 

2. Reserve device 
(CALL "DRES"). 

3. Execute CALL 
"MRKBBG". 

4. Release device 
(CALL "DREL"). 


ERROR 35 

BLOCK USAGE CONFLICT 


The system has in- 
correctly assigned 
a physical block to 
twoof these three 
categories: 

1. Directory use. 

2. Data use. 

3. Bad block 
group. 

Since no block can 
be assigned to 
more than one use 
at a time or overlap 
an adjacent block, 
this error message 
appears. 


Execute a CALL "DUP" 
command. 


ERROR 40 

LOGICAL FILE NUMBER NOT 

FOUND* 


A command execu- 
tion has been at- 
tempted specifying 
a logical file num- 
ber that does not 
exist. This occurs 
when the Ifn in a 
command does not 
match the Ifn speci- 
fied in an earilier 
OPEN command. 


Execute an OPEN com- 
mand with the correct 
Ifn. 
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Error Message 


Cause 

1 


Correction 


ERROR 41 


An OPEN or OPEN 


Execute another OPEN 


ACTIVE LOGICAL FILE NUM- 


"G" command 


command with an 


BER* 


specifying an illegal 


unused Ifn, or close old 




Ifn has been is- 


file. 




sued. This Ifn has 






already been as- 






signed to a file 






which is currently 






active. 




ERROR 42 


The device involved 


Be sure the device ad- 


FILE NOT FOUND* 


does not contain a 


dress and the F.I. are 




file with the speci- 


correct and reissue the 




fied name. 


command. 


ERROR 43 


An attempt was 


Use a different F.I. in the 


DUPLICATE FILE IDENTIFIER* 


made to create a 
new file with an F.I. 
belonging to an ex- 
isting file. 


CREATE command. 


ERROR 44 


A file cannot be 


Change the name of the 


LIBRARY NAME CONFLICT 


created at any level 


file and reissue the 




where there is al- 


CREATE command. 




ready a library of 






the same name. 




ERROR 45 


An attempt was 


Reissue the OPEN com- 


FILE LOCKED* 


made to open a file 


mand using the correct 




without using the 


passwords. 




passwords speci- 






fied in the CREATE 






command. 




ERROR 50 


An attempt was 


If you do wish to write to 


FILE IS WRITE PROTECTED* 


made to WRITE to a 


the file, close it and then 




file opened for read 


reopen it for "full" ac- 




access only. 


cess. 
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Error Message 


Cause 


Correction 


ERROR 51 


A GPIB OPEN com- 


This message appears 


FILE IS RESERVED* 


mand was issued 


when faulty commands 




without setting the 


not involving the ROM 




"wait if file re- 


pack have been issued. 




served" bit. 


See 4907 Service 
Manual. 


ERROR 52 


An attempt was 


Review commands in- 


ILLEGAL FILE OPERATION* 


made to perform an 


volved in carrying out 




illegal file opera- 


the operation to be sure 




tion. 


they are valid for the file 
or information being ac- 
cessed. 


ERROR 53 


An attempt has 


This message does not 


END OF FILE* 


been made to read 


appear if an ON EOF 




past the end of a 


command is used. 




file. 




ERROR 54 


An attempt has 


The attribute C (contigu- 


ILLEGAL FILE EXPANSION* 


been made to write 


ous) may be changed to 




additional data to a 


S (scattered) using the 




noncontiguous lo- 


ASSIGN command. 




cation on the disc 






for a file specified 






"contiguous." 




ERROR 55 


There is not enough 


Delete any unneeded 


NO SPACE* 


uncommitted space 


files (KILL), and gather 




left on the disc for 


the remaining free space 




further storage. 


in a single area with the 
CALL "COMPRS" com- 
mand. I/O command may 
then be reissued. 


ERROR 56 


This message re- 


See 4907 Service 


POINTER NOT AT ITEM BOUND- 


sults from improper 


Manual. 


ARY* 


system operation. 
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Error Message 


Cause 


Correction 


ERROR 57 

ILLEGAL ITEM HEADER* 


The TYPE function 
has encountered an 
illegal item header 
for a standard item 
file. 


See TYP command de- 
scription in Section 5. 


ERROR 60 
FORMAT FAILED* 


If the CALL "FOR- 
MAT" command 
was issued, it has 
failed because the 
disc has too many 
bad blocks or the 
first block contain- 
ing the volume la- 
bel is bad. 

If the CALL 
"FFRMT" command 
was issued, it may 
have failed be- 
cause the old vol- 
ume label was ille- 
gible due to dam- 
age. 


If message appears after 
attempting a complete, 
accurate "full" format, 
choose another disc. 


ERROR 61 

MARK BAD BLOCK GROUP 

FAILED* 


The CALL 
"MRKBBG" com- 
mand failed be- 
cause the bad 
block table in the 
volume label is too 
full or hardware er- 
rors are involved. 


Copy files to a new disc 
or refer to 4907 Service 
Manual. 


ERROR 62 

ILLEGAL ATTRIBUTE CHANGE* 


The ASSIGN com- 
mand contains at- 
tribute entries 
which conflict with 
the existing file 
type. 


Reissue the ASSIGN 
command with correct 
attribute entries. 
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Error Message 


Cause 


Correction 


ERROR 63 


The file name ex- 


Reissue the command 


ILLEGAL IPL FILE* 


tension is not valid 


with the correct exten- 




or the file is not a 


sion construction. 




host binary type. 




ERROR 70 


A COPY ... TO 


Reissue the COPY . . . 


COPY SKIPS LOCKED FILE* 


command without 


TO command using the 




correct passwords 


correct passwords. If the 




was issued to a 


F.I. uses special charac- 




locked file. 


ters to copy multiple 
files, copying will con- 
tinue with the next file. 


ERROR 71 


A COPY ... TO 


If you wish to copy this 


COPY SKIPS OPEN FILE* 


command was at- 


file to another location, it 




tempted on an open 


must first be closed. If 




file. 


the F.I. in the command 
uses special characters 
to copy multiple files, 
copying will continue 
with the next file. 


ERROR 74 


A KILL command 


Reissue the KILL com- 


DELETE SKIPS LOCKED FILE* 


was issued to a 


mand. If you wish to de- 




locked file. 


lete files with pass- 
words, those passwords 
must be entered in the 
F.I. or the master pass- 
word must be used. If 
the specific passwords 
or the master pasword is 
not used, the locked files 
cannot be deleted. 


ERROR 75 


A KILL command 


If you do intend to delete 


DELETE SKIPS OPEN FILE* 


was attempted on 


this file, close it and then 




an open file. 


reissue the KILL com- 
mand. 
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Error Message 


Cause 


Correction 


ERROR 78 


A CALL "RENAME" 


Reissue the CALL "RE- 


RENAME SKIPS LOCKED FILE* 


command without 


NAME" command with 




correct passwords 


the correct passwords. 




was attempted on a 






locked file. 
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FILE POINTER OPERATION 



Since pointer locations may be altered only in sequential files, this discussion is limited to 
that type of file. For clarification, however, a table showing random file pointer locations is 
included. 

Each file is equipped with a "pointer." Although this pointer is invisible to the user, it 
indicates to the 4051 where an I/O operation such as a READ or WRITE is to begin. When 
a file is created, the pointer is automatically positioned at the beginning of the file. Where 
the pointer is positioned after that depends on the access method ("F", "R" or "U") 
specified in the OPEN command. For example, if data is being entered into a new file for 
the first time, an "F" must be specified in the OPEN statement. The pointer will start at the 
beginning of the file as shown in Figure C-1 . 



BEGINNING OF FILE 



END OF 

ALLOCATED 

SPACE 



i 



i 



BEGINNING 
POINTER LOCATION 



Figure C-1. Graphic Representation of Files. 

Once data has been entered, the file is closed. The pointer remains where it was when 
data entry ended (Figure C-2). 



BEGINNING OF FILE 



END OF DATA 



END OF 

ALLOCATED 

SPACE 



♦ 



i 



i 



^^^^m. 





ENDING POINTER LOCATION 



Figure C-2. Pointer location at the end of data entry after an OPEN "F". 
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The next operation may be started with an OPEN, with an "R" (READ), or with a "U" 
(UPDATE). If the "U" is entered in an OPEN, the pointer remains at the end of the data. As 
data is entered, the pointer moves along until data entry is complete. The pointer is still at 
the end of the data, which in Figure C-3 is also the end of the file. 

END OF 
ALLOCATED 
SPACE 
BEGINNING OF FILE (END OF FILE AND END OF DATA) 



I i 



iDATAi 



''•'•'•'•'•'•'•'''^'•'•'•'•'•'•'•'•'™'^^ 



I BEGINNING 
2380-40 POINTER LOCATION 

Figure C-3. Pointer location at the end of data entry after an OPEN "U". 

If an "R" is entered instead of a "U," the pointer is located at the beginning of the file 
(Figure C-4). 

END OF 
ALLOCATED 
BEGINNING OF FILE END OF DATA SPACE 



iDATAi 



^^UdiUUM^^M 



BEGINNING 
POINTER LOCATION 



2380-41 



Figure C-4. Pointer location prior to I/O command after an OPEN "R". 

READ may now be executed. When all the data has been read, an end-of-file message will 
be displayed."* This message indicates that the pointer has reached the end of the data. If, 
at this time, you wish to enter more data, you must execute a CLOSE and another OPEN 
with a "U" for UPDATE. 



^ When an EOF is encountered in a program, the program will abort unless an ON EOF command was 
executed previously. 
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Rewinding 

Normally, the pointer cannot be moved backward to the beginning of a sequential file 
unless a CLOSE and a subsequent OPEN are carried out. There are, however, situations 
when convenient pointer movement is desirable, for example, when you wish to READ or 
reenter data just entered. A CALL "REWIND" command is provided to reposition the 
pointer to the beginning of the file; for example, if a user has completed data entry, the 
pointer would be located as shown in Figure C-5. 



BEGINNING OF FILE 



I 



END OF DATA 



♦ 






DATA 



ENDING POINTER 
LOCATION 



2380-42 



Figure C-5. Pointer Location after Data Entry Before CALL "REWIND". 



If it is necessary to READ or reWRITE to the file, the CALL "REWIND" command can be 
executed. This will move the pointer back to the beginning of the file (Figure C-6). 



BEGINNING OF FILE 



END OF DATA 



I 



I 









't POINTER LOCATION 
■ AFTER CALL "REWIND" 
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Figure C-6. Pointer Location after CALL "REWIND". 



The user may now execute a READ or WRITE without the necessity of a time-consuming 
CLOSE and OPEN. It is important to remember that if a WRITE is executed after a CALL 
"REWIND," all data already in the file will be erased. 

The tables below show the effects of "F", "R" and "U" entries in OPEN commands for 
both sequential and random files. 
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Table C-1 



SEQUENTIAL FILE POINTER LOCATION 



Character En- 
tered In OPEN 
Command 


Is PRINT or 
WRITE Allowed? 


Initial Pointer 
Location 


Pointer Location 
When File CLOSED 


F (Full) 


Yes 


Beginning of file 


Current position 


R (Read) 


No 


Beginning of file 


Current end of data 


U (Update) 


Yes 


End of data 


Current end of data 



Table C-2 



RANDOM FILE POINTER LOCATION 



Character En- 
tered in OPEN 
Command 


Is PRINT or 
WRITE Allowed? 


Initial Pointer 
Location 


Pointer Location 
When File CLOSED 


F or U (Full or 
Update) 


YES 


Always at begin- 
ning of record 
specified in the 
I/O command 


Current end of data 


R (READ) 


NO 


Always at begin- 
ning of record 
specified in the 
I/O command 


Current end of data 



C-4 



4907 FILE MANAGER OPERATOR'S 



APPENDIX D 



4907 FILE MANAGER OPERATOR'S 



Appendix D 
GLOSSARY 



ADDRESS (noun) 



ADDRESS (verb) 



ASCII 



ASCII FILE 



BAD BLOCK GROUP 



BASIC 



BIT 
BYTE 



Refers to number assigned to a particular disc 
device (device address) through setting of adjust- 
able strapping, or to a variable or to a file as 
indicated in an F.I. or by a Ifn. 

The act of communicating with a file, device, 
variable, etc. 

(American Standard Code for Information Inter- 
change) A standardized code of alphanumeric char- 
acters, symbols, and special control characters. 
Each character is represented by eight binary bits 
(a byte) in which seven of the bits distinguish one 
character from another and the eighth bit is re- 
served for parity checking purposes. The system 
ignores the parity bit in any ASCII characters it 
receives, and transmits low parity. (That is, it always 
transmits a for the eighth bit.) 

The data in an ASCII file is a sequence of seven-bit 
ASCII characters. The high order bit is always set to 
zero. If a number is to be stored, it is converted to a 
sequence of ASCII characters. 

An area on the disc which, because of damage or 
surface defects, should not be used for storage. See 
CALL "FORMAT" and CALL "MRKBBG" command 
descriptions. 

An acronym derived from "Beginners All-Purpose 
Symbolic Instruction Code." BASIC is the high-level 
programming language used to command the TEK- 
TRONIX 4051 Graphic System. 

A binary digit; a 1 or a 0. 

A group of eight binary bits. 
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CHAINS 



The number of connections between a library at one 
level and the libraries or files on the following levels. 
The number of chains dictates the speed at which 
the system locates files. 



COMMAND 



A line of instructions containing a keyword(s), 
address(es) and/or an argument. Usually issued 
from 4051 keyboard as contrasted to a statement 
which is issued from a program. 



CONSTANT 



Any entry in a field requiring a literal number rather 
than a representative variable. For example, the 
entry for the Ifn in a command that is not a "CALL" 
command must be an integer of 1 to 9 and not A, B, 
etc. 



CONTIGUOUS FILE 



A file that is not scattered over different locations on 
the disc but is contained within a single area. 



CONTROLLER 



The device which, upon receiving instructions from 
the host, activates peripherals such as drives, 
plotters, printers, etc., depending on the interface 
within the controller. 



CURRENT DEVICE 



The device specified in a UNIT or CALL "UNIT" 
command. Unless otherwise specified, the default 
current device is 0. 



CURRENT LIBRARY 



The library or libraries specified in a CALL "USER- 
LIB" command. The default library is "SCRATCH- 
LIB." 



DEFAULT 



The value or values which the system may assign to 
the fields in a command when no entry is made. 



DELIMITER 



The characters or spaces used to separate one field 
from another. 



DEVICE 

DEVICE ADDRESS 



A disc drive containing a disc. 

The unique number assigned to a particular disc 
device through setting of adjustable strapping. 
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DIMENSIONING 



Enlarging or reducing of string variable space to 
accommodate more or less than the 72 character 
default length. 



DEVICE, RESERVED 



A device reserved for formatting and other device 
management activities. 



DISC 



The recording medium used within a drive. Also may 
be referred to as the "volume", or when residing in 
the drive, the "device." 



DRIVE 
ENTRY 



The apparatus containing the disc. 

The number or character or string placed in a field 
or the variable or string variable representing it. 
Entries are made through program operation or 
keyboard. 



ERROR CONDITION 



The status of the system when an incorrect entry or 
command is encountered; generally, when system 
error conditions occur, error messages are printed 
to the screen. 



EXTENSION 



The identifying "tag" placed on the end of file 
names. Extensions allow the system to distinguish 
between otherwise identical file names. 



F.I. 



File Identifier. Refers to the combination of library 
names and file names required when creating and 
locating files. F.l.'s are required in many system 
commands. 



FIELD 



FILE 



A portion of a command or statement requiring a 
specific entry separated from preceding and subse- 
quent fields with delimiters. 

A collection of data, data items or program state- 
ments recorded on a storage medium. 



FILE IDENTIFIER 



See F.I. 
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FILE, LOGICAL END OF 



An EOF mark is automatically placed at the end of 
all information entered into a file regardless of 
allocated space. When READ, INPUT or OLD com- 
mands are executed, this EOF is encountered and 
signals the controller that all information has been 
transmitted. This also may be referred to as END OF 
DATA. 



FILE, PHYSICAL END OF 



The end of the space allocated to a file by the 
CREATE command. 



FILE POINTER 



Although invisible to the user, the pointer dictates 
where an I/O operation is to begin. The pointer may 
be manipulated with an OPEN or CALL "REWIND" 
command. See FILE POINTER OPERATION (Appen- 
dix C). 



HEADER 



The area preceding each binary standard item 
describing the following item as a string or numeric 
value. The header also indicates the amount of 
space used by the item. Standard items are placed 
into files only with a WRITE command. 



HOST 



The 4907 host (4051 ) controls all system activity 
with the exception of system front panel switches. 



HOST BINARY 



The 4051 saves programs in either ASCII or binary 
form. The binary form is host binary which means it 
can be entered only by another host (4051 ). ASCII 
formats usually can be interpreted by all BASIC- 
based hosts. 



KEYWORD 



The entry in the first field of all system commands. 
The keyword tells the system the kind of activity to 
be carried out. 



LFN 
LIBRARY 



Also Ifn. The acronym for logical file number. 

A "directory" or "menu" containing the listing and 
location of subsequent libraries or files. A library 
itself cannot contain data or program listings. 



LOCKED FILE 



A file that has been assigned a password in its F.I. 
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LOGICAL FILE NUMBER 



The integer from 1 to 9 assigned in the OPEN 
command that represents both the F.I. and the 
device address. Up to 9 files may be open at one 
time. Logical file specifies the internal 4051 
magnetic tape. 



MASTER PASSWORD 



The master password entered in the CALL "FOR- 
MAT" command allows file access in CALL 
"MRKBBG" and KILL commands without use of 
specified passwords. 



MEMORY 



The storage area in the 4051 used to contain 
programs. 



NUMERIC EXPRESSION 



See 4051 Graphic System Reference Manual. 



PASSWORD 



The optional entry that may be placed in the F.I., in 
the CREATE command, immediately following any 
library or file name at any of the five storage levels. 
Subsequent access to files is prevented or limited 
unless the specified passwords are used. See 
USING PASSWORDS IN FILE IDENTIFIERS in Sec- 
tion 4. 



POINTER 
RANDOM FILE 



See FILE POINTER OPERATION (Appendix C). 

A type of file with two or more records of identical 
length. 



RANDOM ACCESS 



The method of storing or locating data by specifying 
a record number and directly accessing that record 
only. Opposite of sequential access. 



RECORDS 



Two or more divisions of equal length in a random 
file. Number and length of records are specified in 
the CREATE command. 



SCATTERED 



The state of a file not in a contiguous form. File 
information is stored in scattered locations through- 
out the disc. Scattered files cannot extend over 
more than a single disc. 
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SCRATCHLIB 



The system name of the default current library. 



SEQUENTIAL FILE 



A type of file with no divisions or "records." 



SEQUENTIAL ACCESS 



The method of storing or locating data by placing 
the file pointer at the beginning of the designated 
file and reading or writing towards the end of the file 
until required information is entered or encountered. 
Opposite of random access. 



SPECIAL CHARACTERS 



Characters that may be used to simplify file access, 
to provide multiple file selection or in multiple file 
name changing. See SPECIAL CHARACTERS IN 
FILE IDENTIFIERS in Section 4. 



STATEMENT 



A command preceded by a line number for program 
use. 



STORAGE STRUCTURE 



A collection of libraries and files. A storage struc- 
ture may be as small as a single file. 



STRING VARIABLE 
SUBFIELD 



See the 4051 Graphic System Reference Manual. 

If two or more entries may be made in a single field, 
they may be considered "subfields;" for example, 
the library and file names in an F.I. are subfields. 



SYSLIB 



The system name of the 1st level system library. 
Generally used for storing commonly used public 
programs, data, etc. 



SYSTEM 



The "system" referred to in this manual includes the 
disc controller, the disc drive or drives, and the host 
(4051). 



SYSTEM CLOCK 



The device in the controller used to record the time 
and date of various device and file management 
activities. 



TIME/DATE STAMP 



The time and date information that is automatically 
recorded on discs and files when device and file 
activity commands are executed. The system clock 
must be operating or no time/date stamps are 
recorded. 
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UNIT NUMBER 



The number assigned in a UNIT command specify- 
ing which device is to be the current device. 



USERLIB 



The system name of the 1 st level user's library. 
Generally used for any private data or program or 
that information specific to a particular subject. 
Unlike SYSLIB or SCRATCHLIB, USERLIB libraries 
can have any name desired: MYLIBRY, YOURLI- 
BRY, A, DOG, etc. 



VARIABLE 
VOLUME 



See the 4051 Graphic System Reference Manual. 

Refers to the storage medium used within the drive. 
Also may be referred to as the "disc." 



VOLUME LABEL 



Wherever a disc is formatted, a "label" is automati- 
cally created, containing information about that disc. 
See DEVICE AND FILE STATUS MESSAGES (Ap- 
pendix A). 
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ROUTINE FLEXIBLE DISC DRIVE MAINTENANCE 



The table below shows routine maintenance for the flexible disc drives. Procedures 1 and 
2 may be performed by the operator. Procedures 3 through 6 should be carried out by a 
Tektronix serviceman and are fully described in the Flexible Disc Drive Service Manual. 







Inspect 




Action 


Procedure 


Item 


For 


Interval 


Required 


1 


Read/write 


Oxide build- 


1 2 months 


Clean read/write 




head 


up resulting 
in repeated 
hard or soft 
errors 




head 


2 


Read/write 
head 


Worn felt 


1 2 months 


Replace button 


3 


Stepper motor 


Nicks, 


1 2 months 


Clean off oil, dust. 




and lead 


burrs, and 




and dirt. Dress 




screw 


dirt 




down nicks or 
burrs, or replace 
part. 


4 


Belt 


Frayed or 
weak areas 


12 months 


Replace 


5 


Base 


Loose screws, 
switches, 
and 
connectors. 

Check for 
dust and 
dirt. 


1 2 months 


Tighten screws, 
connectors, and 
switches. 

Clean off dust and 
dirt 


6 


Read/write 
head 


Aborted 
I/O com- 
mands or 
distorted 
results. 


1 2 months 


Align head. 
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Procedure No. 1 



a. Remove cover from drive (Figure E-1 ). 




Figure E-1 . Removing IMain 4907 Cabinet Cover. 
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b. Remove oxide from head with swab and alcohol (Figure E-2). 




Figure E-2. Cleaning Read/Write Head. 



c. Replace drive cover. 
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Procedure No. 2 



a. Remove cover from drive (Figure E-3). 




Figure E-3. Removing Main 4907 Cabinet Cover. 



b. Remove read/write head button (Figure E-4). 




2380-46 



Figure E-4. Removing Read/Write Head Button. 
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c. Install new read/write head button (Figure E-5). 




Figure E-5. Installing New Read/Write Head Button. 



d. Replace drive cover. 
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SAMPLE PROGRAMS 



These programs are useful in general 4907 File Manager operation. They also 
demonstrate typical use of many system commands. 

1 . RANDOM FILE INITIALIZING PROGRAM 

This is a two-part program. The first part prompts the user to enter start-up sequence 
information required on a day-to-day basis. This information is automatically entered 
in the commands shown in the program listing below. The program will: 

a. Initialize the 4051. 

b. Designate the current device. 

c. Mount the device. 

d. Designate the current library (CALL "USERLIB"). 

e. Set the sytem clock. 

f. Specify the F.I. 

g. Kill (delete) the file If desired. 

h. Create a random file and establish the number of records and record length. See 
CREATE command description for details on determining record length. 

i. Create a sequential file if desired. 

j. Assign file attributes. 

k. Open the file. 

I. Print to the file if desired (ASCII). 

m. Write to the file if desired (binary). 

n. Enter blank strings in all records of random files. See step 9 of GENERAL 
SEQUENCE FLOW CHART in Section 2. 

lee PRINT "IRANDOn file INITIALIZATION PROGRAH" 

lie INIT 

120 PRINT "JENTER DEUICE ADDRESS:"! 

138 INPUT A 

149 CALL -UNIT", A 

158 CALL "MOUNT", A,"" 

168 PRINT "ENTER LIBRARY OR LIBRARIES (DOG/CAT>:"t 

178 INPUT A$ 

188 IF A$="- THEN 288 

198 CALL "USERLIB",A$ 

288 CALL "TIHE",A$ 

218 IF A$<>-" THEN 258 

228 PRINT "ENTER DATE AND TIME: "J 

238 INPUT A$ 

248 CALL "SETTIM",A$ 

258 PRINT "ENTER NAME OF FILE:"; 

268 INPUT A$ 
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278 CALL "FILE-,A,A$,B$ 

288 IF B$^"" THEN 336 

298 PRINT "IF FILE EXISTS DO YOU HANT IT DELETED? <Y OR N):-| 

388 INPUT B$ 

318 IF BfO'Y" THEN 258 

328 KILL A$ 

338 PRINT "ENTER RECORD LENGTH:"? 

348 INPUT a 

358 PRINT "ENTER NUMBER OF RECORDS:"} 

368 INPUT B 

378 PRINT "IS THIS AN ASCII FILE? <Y OR N):"J 

388 C$«"A" 

398 INPUT B$ 

488 IF B$«-Y" THEN 428 

418 C$«"" 

428 PRINT "OTHER ATTRIBUTES THAN "|C$|"RCN? ENTER CHARACTERS^ IF ANY: "I 

438 INPUT B$ 

448 Bt«B$liC$ 

458 CREATE A$,Bt{B»A 

468 IF A-e THEN 628 

478 OPEN A$n»"F">B$ 

488 DIH D$<A-1> 

498 D$«"- 

588 FOR I«l TO A-1-4*<C$<>"A"> 

518 D*«D$I." • 

528 NEXT I 

538 IF C$«"A" THEN 588 

548 FOR I«l TO B 

558 MRITE il,I:D$ 

568 NEXT I 

578 GO TO 618 

588 FOR I«l TO B 

598 PRINT il,I:D$ 

688 NEXT I 

618 CLOSE 1 

628 END 
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2. ASCII DATA TRANSFER FROM TAPE TO DISC FILE 

This program prints ASCII data from an internal 4051 magnetic tape to a specified 
sequential disc file. 

188 IN IT 

118 PRINT -IGCCTftPE TO DISC PROGRAM FOR DEMICE 8- 

128 UNIT 8 

138 CALL "MOUNT", 8f»» 

148 PRINT "JJENTER LIBRARY OR LIBRARIES <DOG/CAT):-> 

158 INPUT A$ 

168 IF A$«"" THEN 188 

178 CALL "USERLIB-jAf 

188 CALL "TIME-,A$ 

198 IF A$<>"" THEN 238 

288 PRINT "DATE AND TIME:"; 

218 INPUT A$ 

228 CALL "SETTIM",A$ 

238 PRINT "ENTER SOURCE FILE NUMBER FROM TAPE:"; 

248 INPUT N 

258 IF Ns8 THEN 428 

268 FIND N 

278 PRINT "ENTER NAME OF DISC FILE ONLY:"; 

288 INPUT A$ 

298 CALL "FILE",8,A$,B$ 

388 IF B$«"" THEN 358 

318 PRINT "SHOULD EXISTING FILE DATA BE ERASED? <Y OR N>:"f 

328 INPUT B$ 

338 IF B$="Y" THEN 378 

348 GO TO 378 

358 CREATE A$,"A";256,8 

368 REM FILE SIZE MILL BE INCREASED AS NECESSARY 

378 OPEN A$;l,"F",B$ 

388 ON EOF <8> THEN 428 

398 T»TYP<e) 

488 GO TO T OF 438,458,488,518 

418 PRINT "EMPTY FILE" 

428 GO TO 548 

438 PRINT -END OF FILE" 

448 GO TO 548 
458 INPUT 933: A$ 
468 PRINT il:A$ 
478 GO TO 398 
488 READ 633: A 
498 PRINT tl:A4 
588 GO TO 398 
518 READ 833: A$ 
528 PRINT il:A$ 
538 GO TO 398 
548 END 
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USING PRINT AND INPUT IN A PROGRAM 



The following programs show how the PRINT and INPUT statements can be used to enter 
and then retrieve entire strings or numeric values within the strings. It is assumed that the 
files already have been created and opened. 



RETRIEVING ENTIRE STRINGS FROM A SEQUENTIAL FILE 

1 00 PRINT #3:"BLACK, TOM, 241 MAIN, MILL CITY, 5464451 " 

1 1 PRINT #3:"BLUE, IRIS, 566 ELM, TWITVILLE, 6475579" 

120 CALL"REWIND",3 

130 INPUT #3:A$,B$ 

140 PRINT A$,B$ 

This program prints these strings on the screen: 

BLACK, TOM, 241 MAIN, MILL CITY, 5464451 

BLUE, IRIS, 566 ELM, TWITVILLE, 6475579 

Line 1 00 Stores all data shown (as a single string at the beginning of logical file 

number 3). 

Line 1 1 Stores the data shown (as a single string following the previous string). 

Line 120 Returns the logical file pointer to the beginning of the file. 

Line 1 30 Reads the first string from logical file number 3 and stores it in A$; then 

reads the second string and stores it in B$. 

Line 1 40 Prints the contents of A$ and B$ to the screen. 
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RETRIEVING NUMERIC VALUES FROM A SEQUENTIAL FILE 



1 00 PRINT #3: "BLACK, 200000" 

110 PRINT #3: "RED, 600" 

120 CALL "REWIND", 3 

130 INPUT #3: A, B 

140 PRINT A, B 



This program prints these values to the screen: 

200000 600 

Line 1 00 Stores all data shown (as a single string at the beginning of logical file 

number 3). 

Line 1 1 Stores all data shown (as a single string following the first string). 

Line 1 20 Sets the logical file pointer back to the beginning of the file. 

Line 1 30 Looks for the first numeric value in the file and stores it in A; then looks for 

the second numeric value and stores it in B. 

Line 140 Prints the values of A and B to the screen. 
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RETRIEVING NUMERIC VALUES FROM A RANDOM FILE 



100 PRINT #3,1 

110 PRINT #3, 2 

1 20 INPUT #3, 1 

130 INPUT #3, 2 

140 PRINT A, B 



"BLUE, 150" 
"GREEN, 200" 
A 
B 



This program prints these values to the screen: 

1 50 200 

Line 1 00 Stores all data shown (as a single string at the beginning of record 1 in 

logical file number 3). 

Line 1 1 Stores all data shown (as a single string at the beginning of record 2 in 

logcial file number 3). 

Line 1 20 Searches through the string in record 1 , locates the first numeric value, 

and stores it in A. 

Line 1 30 Searches through the string in record 2, locates the first numeric value, 

and stores it in B. 

Line 140 Prints the values of A and B to the screen. 



NOTE 

Printing to a random ASCII file must be done carefully. If more data is 
transmitted than can be accommodated in the specified record, the data in 
the following record will be overwritten. 
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USING WRITE AND READ IN A PROGRAM 



The following programs illustrate how standard items can be written to a file, read out, 
assigned to target variables, and printed to the screen. It is assumed the files have been 
previously created and opened. 

RETRIEVING BOTH STRINGS AND NUMBERS FROM A 
SEQUENTIAL FILE 

1 00 WRITE =#3:"RED", "BLUE",1 45 

110 CALL"REWIND",3 

120 READ #3:A$,B$,A 

130 PRINT A$,B$,A 

The program prints these strings and this numeric value to the screen: 

RED BLUE 145 

Line 1 00 Stores the three data items at the beginning of logical file number 3. 

Line 1 1 Returns the logical file pointer to the beginning of the file. 

Line 1 20 Reads the first item and stores it in A$, reads the second item and stores it 

in B$ and reads the numeric value and stores it in A. If the target variables 
are out of order (for example, A, A$, B$, or A$, A, B$), an error message 
appears. 

Line 1 30 Prints contents of A$, B$, A to the screen in that order. 
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RETRIEVING ONLY NUMBERS FROM A SEQUENTIAL FILE 

1 00 WRITE #3: "WHITE", 1 23, "RED", 456, "YELLOW", 789 

110 CALL "REWIND", 3 

1 20 READ #3: A$, A, A$, B, A$, C 

130 PRINTA, B, C 

The program prints the numeric values only: 

1 23 456 789 

Line 1 00 Stores the six data Items at the beginning of logical file number 3. 

Line 110 Returns the logical file pointer to the beginning of the file. 

Line 1 20 Reads each data item in turn and stores it in the specified target variable. 

"WHITE" goes to A$, 1 23 goes to A, and so on. The order of the target 
variables must match the order of the data strings, or an error message wil 
appear. 

Line 1 30 Prints only the values of A, B, and C to the screen. 
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Accessories, standard and optional 1 -6, 1 -7 

Address 4-1 

Address strapping 2-1 

Allocated space 5-55, 5-84 

Argument 4-2 

ASCII 5-97, D-1 

BASIC ix, xiii, 1 -1 , 4-1 , D-1 

Binary 5-1 06 

Blocks 5-40, A-4 

Braces 5-3 

Brackets 5-2 

Bytes 5-65, 5-84, A-1 , 

A-4, D-1 

Chains 5-33 

Changing names 5-43, 5-53 

Clock 2-8, 2-18, 5-9, 

5-11, A-1 

Colons 4-5, 4-26 

Command delimiters 4-5 

Command descriptions 

APPEND 5-89 

ASSIGN 5-43 

CLOSE 5-45 

COMPRESS (CALL "COMPRS") 5-19 

CONTROLLER/UNIT STATUS (CALL "CUSTAT") 5-21 

COPY ... TO 5-47 

CREATE 5-54 

DELETE ALL 5-5 

DEVICE RELEASE (CALL "DREL") 5-25 

DEVICE RESERVE (CALL "DRES") 5-27 

DEVICE STATUS MESSAGE (CALL "DSTAT") 5-29 

DIRECTORY 5-59 

DISMOUNT (CALL "DISMOUNT") 5-23 

DUPLICATE (CALL "DUP"). 5-62 

END 5-64 

FAST FORMAT (CALL "FFRMT") 5-31 

FILE MANAGER VALUES (CALL "FMVALS") 5-6 

FILE STATUS (CALL "FILE") 5-65 

FORMAT (CALL "FORMAT") 5-32 

HARD ERROR STATUS (CALL "HERRS") 5-36 
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INITIALIZE 5-8 

INPUT 5-92 

KILL 5-67 

MARK BAD BLOCK (CALL "MRKBBG") 5-40 

MOUNT (CALL "MOUNT") 5-38 

NEXT (CALL "NEXT") 5-69 

OLD 5-95 

ON END-OF-FILE 5-71 

OPEN 5-73 

PRINT 5-97 

READ 5-101 

RENAME (CALL "RENAME") 5-78 

REWIND (CALL "REWIND") 5-81 

SAVE 5-1 04 

SECRET 5-83 

SET TIME (CALL "SETTIM") 5-9 

SPACE (CALL "SPACE") 5-84 

TIME (CALL "TIME") 5-11 

TYPE (Function) 5-86 

UNIT 5-1 2, 5-1 4 

USER LIBRARY (Current library) 5-16 

WRITE 5-1 06 

Command punctuation 4-5 

Command examples 4-6 

Command summaries 2-11 

Commas 4-5 

Configuration, 4907 1-1 

Configuration, 4907 Option 30 1-2 

Configuration, 4907 Option 31 1-2 

Constant 4-3, D-2 

Contiguous files 5-55 

Controller 1-1 

Controller/device commands 5-19 

Controls and indicators 1-3 

Current device 5-12 

Current library 5-16 

Delimiters, command 4-5 

Delimiters, file identifier 4-26 

Descriptive form 5-3 

Device (also see Drive) 5-12, D-2 

Device status message A-4 

Dimensioning 4-4 

Disc, see specifications, flexible disc 

Drive (also see Device) 1-1, 6-3 
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Error messages B-1 

Extending files 2-19, 5-84 

Extensions 4-25 

Features ix, 2-1 8 

Field descriptions, command 4-1 

Field descriptions, F.I 4-16 

Fields 4-1,4-16 

File description 2-1 7, 3-1 

File extending 2-19, 5-84 

File identifier 1 -3, 4-1 2 

File length 5-54 

File management commands 5-43 

File pointer operation C-1 

File status message A-1 

Files 2-1 7, 3-1 

Files, contiguous 5-54 

Files, sequential 2-17 

Flexible disc loading 2-4 

Flexible disc specifications 6-4 

Flexible disc storage and handling 2-6 

Flow chart, general sequence 2-8 

GPIB cable 2-2 

Group OPEN 2-20, 5-73 

Host x 

Instrumentation xii 

I/O commands, file 5-89 

I/O program 2-15 

Keyword 4-1 

Length, file 5-54 

Levels 3-1 , 3-2, 4-1 6 

Ifn (see Logical File Number) 

Libraries 3-2, 3-3, 4-1 2 

Line numbers 5-3 

Loading, flexible disc 2-4 

Logical File Number 4-2, 5-73 

Maintenance, routine flexible disc drive E-1 

Master password 5-31 , 5-32 

Message, device status A-4 

Message, file status A-1 

Multiple file selection 4-27 

Multiple file name changing 5-53 

Multiple file transfers 5-49 

Numeric expressions 4-3 

Numeric variable 4-4 



4907 FILE MANAGER OPERATOR'S @ |-3 



INDEX 



Option 10 5-59 

Passwords 4-22 

Peripherals xiii 

Pointer (see File pointer operation) 

Power-up 2-3 

Preparation 2-1 

Prerequisites 5-3 

Printer xiii, 5-59 

Programming xii, 5-92, 5-97 

G-1,H-1 

Programs, sample 2-1 5, F-1 

Punctuation, command 4-5 

Questions and answers xi 

Quotation marks 4-5, 4-26 

Random access (also see I/O commands, file) 2-18, 2-20 

Random files 2-18 

Records 2-18, 5-54 

Recovery procedures B-1 

Releasing a device 5-25 

Reserved device 5-27 

ROM Expander (4051 E01 ) 2-3 

ROM pack 1 -1 , 2-2, 6-5 

Sample I/O program 2-15 

Sample programs 2-1 5, F-1 

Scattered files 5-54 

Scratch library (SCRATCHLIB) 4-17, 4-21 

Selection, multiple file 4-27, 4-38 

Semicolons 4-5 

Sequential access (also see I/O commands, file) 2-17 

Sequential files 2-17 

Simultaneous file use 2-20 

Spaces 4-5 

Special characters 2-19, 4-27 

Specifications, 4907 performance 6-1 

Specifications, 4907 physical 6-1 

Specifications, electrical 6-3 

Specifications, environmental 6-2 

Specifications, flexible disc 6-4 

Status messages 2-1 9, A-1 

Storage structure 3-1 

Strapping, address 2-1 

String constants 4-3 

String variables 4-4 

Surface analysis 5-31 , 5-32 
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Syntax 4-3 

Syntax form 5-2 

System clock 2-8, 2-1 8, 5-9 

5-11, A-1 

System commands 5-5 

System library (SYSLIB) 4-17 

Target numeric variable 4-6 

Target string variable 4-4 

Trailing dots 4-6 

Transfers, multiple files 5-49 

User library 4-17, 4-20 

Variables 4-4, 4-5 

Volume D-7 

Volume label 5-31 , 5-32, 

5-62 

Write-protect hole 2-4 

Write-protect switches 1 -3, 1 -4, 1 -5 
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